- NAME
-
- gcloud components list - list the status of all Google Cloud CLI components
- SYNOPSIS
-
-
gcloud components list[--only-local-state] [--show-platform] [--show-versions] [--filter=EXPRESSION] [--limit=LIMIT] [--sort-by=[FIELD, …]] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
- This command lists all the available components in the Google Cloud CLI. For
each component, the command lists the following information:
- Status on your local workstation: not installed, installed (and up to date), and update available (installed, but not up to date)
- Name of the component (a description)
- ID of the component (used to refer to the component in other [gcloud components] commands)
- Size of the component
- EXAMPLES
- To list the status of all Google Cloud CLI components, run:
gcloud components listTo show the currently installed version (if any) and the latest available version of each component, run:
gcloud components list --show-versions - FLAGS
-
-
--only-local-state - Only show locally installed components.
-
--show-platform - Show operating system and architecture of all components
-
--show-versions - Show installed and available versions of all components.
-
- LIST COMMAND FLAGS
-
-
--filter=EXPRESSION - Apply a Boolean filter
EXPRESSIONto each resource item to be listed. If the expression evaluatesTrue, 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. -
--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.
-
- 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 helpfor details.
gcloud components list
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.

