gcloud-help/gcloud/alpha/compute/instance-groups/list

NAME
    gcloud alpha compute instance-groups list - list Google Compute Engine
        instance groups

SYNOPSIS
    gcloud alpha compute instance-groups list [NAME ...]
        [--regexp=REGEXP, -r REGEXP]
        [--regions=[REGION,...] | --zones=[ZONE,...]] [--filter=EXPRESSION]
        [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri]
        [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (ALPHA) gcloud alpha compute instance-groups list displays all Google
    Compute Engine instance groups in a project.

    By default, instance groups from all regions and instance groups from all
    zones are listed. The results can be narrowed down by providing the
    --regions or --zones flag.

EXAMPLES
    To list all instance groups in a project in table form, run:

        $ gcloud alpha compute instance-groups list

    To list the URIs of all instance groups in a project, run:

        $ gcloud alpha compute instance-groups list --uri

    To list all instance groups in the us-central1 and europe-west1 regions,
    given they are regional resources, run:

        $ gcloud alpha compute instance-groups list \
            --filter="region:( europe-west1 us-central1 )"

    To list all instance groups in zones us-central1-b and europe-west1-d,
    given they are zonal resources, run:

        $ gcloud alpha compute instance-groups list \
            --filter="zone:( europe-west1-d us-central1-b )"

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.

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.

     At most one of these can be specified:

       --regions=[REGION,...]
          If provided, only regional resources are shown. If arguments are
          provided, only resources from the given regions are shown.

       --zones=[ZONE,...]
          If provided, only zonal resources are shown. If arguments are
          provided, only resources from the given zones are shown.

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
    This command is currently in alpha and might 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. These variants are also available:

        $ gcloud compute instance-groups list

        $ gcloud beta compute instance-groups list