gcloud preview compute accelerator-interconnects query-formability

INFORMATION
gcloud preview compute accelerator-interconnects query-formability is supported in universe domain universe; however, some of the values used in the help text may not be available. Command examples may not work as-is and may requires changes before execution.
NAME
gcloud preview compute accelerator-interconnects query-formability - query formability for accelerator interconnects
SYNOPSIS
gcloud preview compute accelerator-interconnects query-formability --subblocks=SUBBLOCK,[SUBBLOCK,…] [--endpoint-mode=ENDPOINT_MODE] [--topology=TOPOLOGY] [--zone=ZONE] [GCLOUD_WIDE_FLAG …]
DESCRIPTION
(PREVIEW) gcloud preview compute accelerator-interconnects query-formability queries hierarchical partition trees across dense reservation subblocks to determine physical topology health, instance lifecycle states, and placement formability for accelerator interconnects in a specified zone.
EXAMPLES
To query formability for subblock sb-1 in zone us-central1-a: 
gcloud preview compute accelerator-interconnects query-formability --zone=us-central1-a --subblocks=sb-1

To query formability across multiple subblocks: 

gcloud preview compute accelerator-interconnects query-formability --zone=us-central1-a --subblocks=sb-1,sb-2

To filter results by a specific accelerator topology shape (e.g., 4x4x4): 

gcloud preview compute accelerator-interconnects query-formability --zone=us-central1-a --subblocks=sb-1 --topology=4x4x4
REQUIRED FLAGS
--subblocks=SUBBLOCK,[SUBBLOCK,…]
List of reservation subblock names or resource URLs to evaluate.
OPTIONAL FLAGS
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide enhanced data residency and reliability by ensuring your request is handled entirely within the specified Google Cloud region. This differs from global endpoints, which may process parts of the request outside the target region. Overrides the default regional/endpoint_mode property value for this command invocation. ENDPOINT_MODE must be one of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global endpoints. Recommended for most users.
--topology=TOPOLOGY
Filter results to partitions matching the specified accelerator topology shape.
--zone=ZONE
Zone of the accelerator interconnect to query formability. If not specified and the compute/zone property isn't set, you might be prompted to select a zone (interactive mode only).

To avoid prompting when this flag is omitted, you can set the compute/zone property: 

gcloud config set compute/zone ZONE

A list of zones can be fetched by running: 

gcloud compute zones list

To unset the property, run: 

gcloud config unset compute/zone

Alternatively, the zone can be stored in the environment variable CLOUDSDK_COMPUTE_ZONE.

GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.

Run $ gcloud help for details.

NOTES
This command is currently in DEVELOPER PREVIEW and may change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early access allowlist.