gcloud auth list [--filter-account=FILTER_ACCOUNT] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,…]] [GCLOUD_WIDE_FLAG …]
gcloud init, gcloud auth login and
gcloud auth
activate-service-account, and shows which account is active. The
active account is used by gcloud and other Google Cloud CLI tools to access
Google Cloud Platform. While there is no limit on the number of accounts with
stored credentials, there is only one active account.
gcloud config set core/account your-email-account@gmail.comIf you don't have an existing account, create one using:
gcloud initTo list the active account name:
gcloud auth list --filter=status:ACTIVE --format="value(account)"
To list the inactive account names with prefix test:
gcloud auth list --filter="-status:ACTIVE account:test*" --format="value(account)"--filter-account=FILTER_ACCOUNTPATTERN" to select accounts that match
PATTERN.
--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.
--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 auth listgcloud beta auth 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.