gcloud compute instances list
Archived: 2026-04-05 20:45:41 UTC
NAME
gcloud compute instances list - list Compute Engine instances
SYNOPSIS
gcloud compute instances list [ NAME …] [ --regexp = REGEXP , -r REGEXP ] [ --zones = ZONE ,
[ ZONE ,…]] [ --filter = EXPRESSION ] [ --limit = LIMIT ] [ --page-size = PAGE_SIZE ] [ --sort-by =
[ FIELD ,…]] [ --uri ] [ GCLOUD_WIDE_FLAG … ]
DESCRIPTION
gcloud compute instances list displays all Compute Engine instances in a project.
EXAMPLES
To list all instances in a project in table form, run:
See more code actions.
gcloud compute instances list
To list the URIs of all instances in a project, run:
See more code actions.
gcloud compute instances list --uri
To list the IPv6 info of all instances in a project, run:
gcloud compute instances list --format="table(
name,
zone.basename(),
networkInterfaces[].stackType.notnull().list(),
networkInterfaces[].ipv6AccessConfigs[0].externalIpv6.notnull().list():label=EXTERNAL_IPV6,
networkInterfaces[].ipv6Address.notnull().list():label=INTERNAL_IPV6)"
POSITIONAL ARGUMENTS
[ NAME …]
(DEPRECATED) If provided, show details for the specified names and/or URIs of resources.
Argument NAME is deprecated. Use --filter="name=( 'NAME' … )" instead.
https://cloud.google.com/sdk/gcloud/reference/compute/instances/list
Page 1 of 3

FLAGS
--regexp = REGEXP , -r REGEXP
(DEPRECATED) Regular expression to filter the names of the results on. Any names that do not
match the entire regular expression will be filtered out.
Flag --regexp is deprecated. Use --filter="name~'REGEXP'" instead.
--zones = ZONE ,[ ZONE ,…]
If provided, only resources from the given zones are queried.
LIST COMMAND FLAGS
--filter = EXPRESSION
Apply a Boolean filter EXPRESSION 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 = LIMIT
Maximum number of resources to list. The default is unlimited . This flag interacts with other
flags that are applied in this order: --flatten , --sort-by , --filter , --limit .
--page-size = PAGE_SIZE
Some services group resource list output into pages. This flag specifies the maximum number of
resources per page. The default is determined by the service if it supports paging, otherwise it is
unlimited (no paging). Paging may be applied before or after --filter and --limit
depending on the service.
--sort-by =[ FIELD ,…]
Comma-separated list of resource field key names to sort by. The default order is ascending. Prefix
a field with ``~´´ for descending order on that field. This flag interacts with other flags that are
applied in this order: --flatten , --sort-by , --filter , --limit .
--uri
Print a list of resource URIs instead of the default output, and change the command output to a list
of URIs. If this flag is used with --format , the formatting is applied on this URI list. To display
URIs alongside other keys instead, use the uri() transform.
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
https://cloud.google.com/sdk/gcloud/reference/compute/instances/list
Page 2 of 3

These variants are also available:
gcloud alpha compute instances list
gcloud beta compute instances list
Source: https://cloud.google.com/sdk/gcloud/reference/compute/instances/list
https://cloud.google.com/sdk/gcloud/reference/compute/instances/list
Page 3 of 3