gcloud compute networks subnets list-usable [--service-project=SERVICE_PROJECT] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,…]] [--uri] [GCLOUD_WIDE_FLAG …]
gcloud compute networks subnets list-usable is used to list Compute
Engine subnetworks in a project that the user has permission to use.
By default, usable subnetworks are listed for the default Google Cloud project
and user account. These values can be overridden by setting the global flags:
--project=PROJECT_ID and/or --account=ACCOUNT.
gcloud compute networks subnets list-usable
To list all subnetworks in the host project
of Shared VPC that are
usable in the service project
HOST_PROJECT_ID (see Shared VPC
documentation) by the default user:
SERVICE_PROJECT_ID
gcloud compute networks subnets list-usable --project=HOST_PROJECT_ID --service-project=SERVICE_PROJECT_ID
To list all subnetworks in the project
that are usable by the user
PROJECT_ID:
ACCOUNT
gcloud compute networks subnets list-usable --project=PROJECT_ID --account=ACCOUNT--service-project=SERVICE_PROJECT--filter=EXPRESSIONEXPRESSION to each resource item
to be listed. If the expression evaluates True, then that item is
listed. For more details and examples of filter expressions, run $ gcloud topic filters. This flag
interacts with other flags that are applied in this order:
--flatten, --sort-by, --filter,
--limit.
--limit=LIMITunlimited. This
flag interacts with other flags that are applied in this order:
--flatten, --sort-by, --filter,
--limit.
--page-size=PAGE_SIZEunlimited (no paging).
Paging may be applied before or after --filter and
--limit depending on the service.
--sort-by=[FIELD,…]--flatten, --sort-by, --filter,
--limit.
--uri--format, the formatting is applied on this URI list. To display
URIs alongside other keys instead, use the uri() transform.
--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.
gcloud alpha compute networks subnets list-usablegcloud beta compute networks subnets list-usablegcloud preview compute networks subnets list-usable
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.