gcloud preview

NAME
gcloud preview - preview versions of gcloud commands
SYNOPSIS
gcloud previewGROUP |COMMAND[--account=ACCOUNT][--billing-project=BILLING_PROJECT][--configuration=CONFIGURATION][--flags-file=YAML_FILE][--flatten=[KEY,…]][--format=FORMAT][--help][--project=PROJECT_ID][--quiet,-q][--verbosity=VERBOSITY; default="warning"][--version,-v][-h][--access-token-file=ACCESS_TOKEN_FILE][--impersonate-service-account=SERVICE_ACCOUNT_EMAILS][--log-http][--trace-token=TRACE_TOKEN][--no-user-output-enabled]
DESCRIPTION
(PREVIEW) Preview versions of gcloud commands.
GLOBAL FLAGS
--account=ACCOUNT
Google Cloud user account to use for invocation. Overrides the defaultcore/account property value for this command invocation.
--billing-project=BILLING_PROJECT
The Google Cloud project that will be charged quota for operations performed ingcloud. If you need to operateon one project, but need quota against a different project, you can use thisflag to specify the billing project. If bothbilling/quota_projectand--billing-project are specified,--billing-projecttakes precedence. Run$gcloudconfig set --help to see more information aboutbilling/quota_project.
--configuration=CONFIGURATION
File name of the configuration to use for this command invocation. For moreinformation on how to use configurations, run:gcloud topicconfigurations. You can also use the CLOUDSDK_ACTIVE_CONFIG_NAMEenvironment variable to set the equivalent of this flag for a terminal session.
--flags-file=YAML_FILE
A YAML or JSON file that specifies a--flag:valuedictionary. Useful for specifying complex flag values with special charactersthat work with any command interpreter. Additionally, each--flags-file arg is replaced by its constituent flags. See $gcloud topic flags-file formore information.
--flatten=[KEY,…]
Flattenname[] output resource slices inKEY into separate records for each item in each slice.Multiple keys and slices may be specified. This also flattens keys for--format and--filter. For example,--flatten=abc.def flattensabc.def[].ghi references toabc.def.ghi. A resource record containingabc.def[]with N elements will expand to N records in the flattened output. This allows usto specify whatresource-key thefilter will operateon. This flag interacts with other flags that are applied in this order:--flatten,--sort-by,--filter,--limit.
--format=FORMAT
Sets the format for printing command output resources. The default is acommand-specific human-friendly output format. If bothcore/formatand--format are specified,--format takes precedence.--format andcore/format both take precedence overcore/default_format. The supported formats are limited to:config,csv,default,diff,disable,flattened,get,json,list,multi,none,object,table,text,value,yaml. For more details run $gcloud topic formats. Run$gcloud config set --help tosee more information aboutcore/format
--help
Display detailed help.
--project=PROJECT_ID
The Google Cloud project ID to use for this invocation. If omitted, then thecurrent project is assumed; the current project can be listed usinggcloudconfig list --format='text(core.project)' and can be set usinggcloud config set project PROJECTID.

--project and its fallbackcore/project property playtwo roles in the invocation. It specifies the project of the resource to operateon. It also specifies the project for API enablement check, quota, and billing.To specify a different project for quota and billing, use--billing-project orbilling/quota_project property.

--quiet,-q
Disable all interactive prompts when runninggcloud commands. If input is required,defaults will be used, or an error will be raised.

Overrides the default core/disable_prompts property value for this commandinvocation. This is equivalent to setting the environment variableCLOUDSDK_CORE_DISABLE_PROMPTS to 1.

--verbosity=VERBOSITY; default="warning"
Override the default verbosity for this command. Overrides the defaultcore/verbosity property value for this command invocation.VERBOSITY must be one of:debug,info,warning,error,critical,none.
--version,-v
Print version information and exit. This flag is only available at the globallevel.
-h
Print a summary help and exit.
OTHER FLAGS
--access-token-file=ACCESS_TOKEN_FILE
A file path to read the access token. Use this flag to authenticategcloud with an access token. Thecredentials of the active account (if exists) will be ignored. The file shouldonly contain an access token with no other information. Overrides the defaultauth/access_token_file property value for this command invocation.
--impersonate-service-account=SERVICE_ACCOUNT_EMAILS
For thisgcloud invocation, allAPI requests will be made as the given service account or target service accountin an impersonation delegation chain instead of the currently selected account.You can specify either a single service account as the impersonator, or acomma-separated list of service accounts to create an impersonation delegationchain. The impersonation is done without needing to create, download, andactivate a key for the service account or accounts.

In order to make API requests as a service account, your currently selectedaccount must have an IAM role that includes theiam.serviceAccounts.getAccessToken permission for the serviceaccount or accounts.

Theroles/iam.serviceAccountTokenCreator role has theiam.serviceAccounts.getAccessToken permission. You can also createa custom role.

You can specify a list of service accounts, separated with commas. This createsan impersonation delegation chain in which each service account delegates itspermissions to the next service account in the chain. Each service account inthe list must have theroles/iam.serviceAccountTokenCreator role onthe next service account in the list. For example, when--impersonate-service-account=SERVICE_ACCOUNT_1,SERVICE_ACCOUNT_2,the active account must have theroles/iam.serviceAccountTokenCreator role onSERVICE_ACCOUNT_1, which must have theroles/iam.serviceAccountTokenCreator role onSERVICE_ACCOUNT_2.SERVICE_ACCOUNT_1 is the impersonatedservice account andSERVICE_ACCOUNT_2 isthe delegate.

Overrides the defaultauth/impersonate_service_account propertyvalue for this command invocation.

--log-http
Log all HTTP server requests and responses to stderr. Overrides the defaultcore/log_http property value for this command invocation.
--trace-token=TRACE_TOKEN
Token used to route traces of service requests for investigation of issues.Overrides the defaultcore/trace_token property value for thiscommand invocation.
--user-output-enabled
Print user intended output to the console. Overrides the defaultcore/user_output_enabled property value for this commandinvocation. Use--no-user-output-enabled to disable.
GROUPS
GROUP is one of the following:
config
(PREVIEW) View and edit Google Cloud CLI properties.
COMMANDS
COMMAND is one of the following:
help
(PREVIEW) Search gcloud help text.
init
(PREVIEW) Initialize or reinitialize gcloud.
survey
(PREVIEW) Invoke a customer satisfaction survey for Google CloudCLI.
NOTES
This command is currently in DEVELOPER PREVIEW and may change without notice. Ifthis command fails with API permission errors despite specifying the correctproject, you might be trying to access an API with an invitation-only earlyaccess allowlist.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-05-07 UTC.