gcloud config

gcloud config - view and edit Google Cloud CLI properties

gcloud config GROUP | COMMAND [GCLOUD_WIDE_FLAG …]

A configuration is a set of properties that govern the behavior of gcloud and other Google Cloud CLI tools. The initial default configuration is set when gcloud init is run. You can create additional named configurations using gcloud init or gcloud config configurations create.

To display the path of the active configuration along with information about the current gcloud environment, run $ gcloud info.

To switch between configurations, use gcloud config configurations activate.

gcloud supports several flags that have the same effect as properties in a configuration (for example, gcloud supports both the --project flag and project property). Properties differ from flags in that flags affect command behavior on a per-invocation basis. Properties allow you to maintain the same settings across command executions.

In addition to setting properties in a configuration, and the use of flags, it is possible to override the value of a property with an environment variable. The matching environment variable for a property is of the form 'CLOUDSDK_CATEGORY_PROPERTY'. For example, to demonstrate overriding the project property in the core category to my-project, use a command like:

CLOUDSDK_CORE_PROJECT=my-project gcloud config get core/project

For more information on configurations, see gcloud topic configurations.

Run $ gcloud help for details.

configurations

Manage the set of gcloud named configurations.

get

Print the value of a Google Cloud CLI property.

list

List Google Cloud CLI properties for the currently active configuration.

set

Set a Google Cloud CLI property.

unset

Unset a Google Cloud CLI property.

core

account

Account gcloud should use for authentication. Run gcloud auth list to see your currently available accounts.

console_log_format

Control the format used to display log messages to the console.

Valid values are:

• standard - Simplified log messages are displayed on the console.
• detailed - More detailed messages are displayed on the console.

If unset, default is standard.

custom_ca_certs_file

Absolute path to a custom CA cert file.

default_format

Sets the default format for printing command resources. core/default_format overrides the default yaml format. If the command contains a command-specific output format, it takes precedence over the core/default_format value. Use --verbosity=debug flag to view the command-specific format. Both core/format and --format also take precedence over core/default_format. The supported formats are limited to: config, default, disable, flattened, json, list, none, object, text. For more details run $ gcloud topic formats. Run $ gcloud config set --help to see more information about core/default_format

default_regional_backend_service

If True, backend services in gcloud compute backend-services will be regional by default. Setting the --global flag is required for global backend services.

disable_color

If True, color will not be used when printing messages in the terminal.

disable_file_logging

If True, gcloud will not store logs to a file. This may be useful if disk space is limited.

disable_prompts

If True, the default answer will be assumed for all user prompts. However, for any prompts that require user input, an error will be raised. This is equivalent to either using the global --quiet flag or setting the environment variable CLOUDSDK_CORE_DISABLE_PROMPTS to 1. Setting this property is useful when scripting with gcloud.

disable_usage_reporting

If True, anonymous statistics on SDK usage will not be collected. This value is set by your choices during installation, but can be changed at any time. For more information, see Usage statistics.

format

Sets the format for printing all command resources. This overrides the default command-specific human-friendly output format. Use --verbosity=debug flag to view the command-specific format. If both core/default_format and core/format are specified, core/format takes precedence. If both core/format and --format are specified, --format takes precedence. The supported formats are limited to: config, default, disable, flattened, json, list, none, object, text. For more details run $ gcloud topic formats. Run $ gcloud config set --help to see more information about core/format

log_http

If True, log HTTP requests and responses to the logs. To see logs in the terminal, adjust verbosity settings. Otherwise, logs are available in their respective log files.

max_log_days

Maximum number of days to retain log files before deleting. If set to 0, turns off log garbage collection and does not delete log files. If unset, the default is 30 days.

parse_error_details

If True, gcloud will attempt to parse and interpret error details in API originating errors. If False, gcloud will write flush error details as is to stderr/log.

pass_credentials_to_gsutil

If True, pass the configured Google Cloud CLI authentication to gsutil.

project

Project ID of the Cloud Platform project to operate on by default. This can be overridden by using the global --project flag.

show_structured_logs

Control when JSON-structured log messages for the current verbosity level (and above) will be written to standard error. If this property is disabled, logs are formatted as text by default.

Valid values are:

• never - Log messages as text
• always - Always log messages as JSON
• log - Only log messages as JSON if stderr is a file
• terminal - Only log messages as JSON if stderr is a terminal

If unset, default is never.

trace_token

Token used to route traces of service requests for investigation of issues. This token will be provided by Google support.

universe_domain

Sets the domain of the universe to use for API requests.

user_output_enabled

True, by default. If False, messages to the user and command output on both standard output and standard error will be suppressed.

verbosity

Default logging verbosity for gcloud commands. This is the equivalent of using the global --verbosity flag. Supported verbosity levels: debug, info, warning, error, critical, and none.

accessibility

screen_reader

Make gcloud more screen reader friendly.

ai

region

Default region to use when working with AI Platform resources. When a --region flag is required but not provided, the command will fall back to this value, if set.

ai_platform

region

Default region to use when working with AI Platform Training and Prediction resources (currently for Prediction only). It is ignored for training resources for now. The value should be either global or one of the supported regions. When a --region flag is required but not provided, the command will fall back to this value, if set.

api_endpoint_overrides

accessapproval

Overrides API endpoint for gcloud access-approval command group. Defaults to https://accessapproval.googleapis.com/

accesscontextmanager

Overrides API endpoint for gcloud access-context-manager command group. Defaults to https://accesscontextmanager.googleapis.com/

agentidentity

Overrides API endpoint for gcloud agent-identity command group. Defaults to https://agentidentity.googleapis.com/

ai

Overrides API endpoint for gcloud ai command group.

aiplatform

Overrides API endpoint for gcloud ai-platform command group. Defaults to https://aiplatform.googleapis.com/

anthosevents

Overrides API endpoint for gcloud anthos command group. Defaults to https://anthosevents.googleapis.com/

anthospolicycontrollerstatus_pa

Overrides API endpoint for gcloud container fleet policycontroller command group. Defaults to https://anthospolicycontrollerstatus-pa.googleapis.com/

apigateway

Overrides API endpoint for gcloud api-gateway command group. Defaults to https://apigateway.googleapis.com/

apigee

Overrides API endpoint for gcloud apigee command group. Defaults to https://apigee.googleapis.com/

appengine

Overrides API endpoint for gcloud app command group. Defaults to https://appengine.googleapis.com/

apphub

Overrides API endpoint for gcloud apphub command group. Defaults to https://apphub.googleapis.com/

appoptimize

Overrides API endpoint for gcloud app-optimize command group. Defaults to https://appoptimize.googleapis.com/

apptopology

Overrides API endpoint for gcloud app-topology command group. Defaults to https://apptopology.googleapis.com/

artifactregistry

Overrides API endpoint for gcloud artifacts command group. Defaults to https://artifactregistry.googleapis.com/

assuredworkloads

Overrides API endpoint for gcloud assured command group. Defaults to https://assuredworkloads.googleapis.com/

auditmanager

Overrides API endpoint for gcloud audit-manager command group. Defaults to https://auditmanager.googleapis.com/

baremetalsolution

Overrides API endpoint for gcloud bms command group. Defaults to https://baremetalsolution.googleapis.com/

bigtableadmin

Overrides API endpoint for gcloud bigtable command group. Defaults to https://bigtableadmin.googleapis.com/

certificatemanager

Overrides API endpoint for gcloud certificate-manager command group. Defaults to https://certificatemanager.googleapis.com/

cloudapiregistry

Overrides API endpoint for gcloud api-registry command group. Defaults to https://cloudapiregistry.googleapis.com/

cloudasset

Overrides API endpoint for gcloud asset command group. Defaults to https://cloudasset.googleapis.com/

cloudbilling

Overrides API endpoint for gcloud billing command group. Defaults to https://cloudbilling.googleapis.com/

cloudbuild

Overrides API endpoint for gcloud builds command group. Defaults to https://cloudbuild.googleapis.com/

cloudcommerceconsumerprocurement

Overrides API endpoint for gcloud commerce-procurement command group. Defaults to https://cloudcommerceconsumerprocurement.googleapis.com/

clouddeploy

Overrides API endpoint for gcloud deploy command group. Defaults to https://clouddeploy.googleapis.com/

clouderrorreporting

Overrides API endpoint for gcloud error-reporting command group. Defaults to https://clouderrorreporting.googleapis.com/

cloudfunctions

Overrides API endpoint for gcloud functions command group. Defaults to https://cloudfunctions.googleapis.com/

cloudidentity

Overrides API endpoint for gcloud identity command group. Defaults to https://cloudidentity.googleapis.com/

cloudkms

Overrides API endpoint for gcloud kms command group. Defaults to https://cloudkms.googleapis.com/

cloudlocationfinder

Overrides API endpoint for gcloud cloudlocationfinder command group. Defaults to https://cloudlocationfinder.googleapis.com/

cloudresourcemanager

Overrides API endpoint for gcloud projects command group. Defaults to https://cloudresourcemanager.googleapis.com/

cloudscheduler

Overrides API endpoint for gcloud scheduler command group. Defaults to https://cloudscheduler.googleapis.com/

cloudsecuritycompliance

Overrides API endpoint for gcloud compliance-manager command group. Defaults to https://cloudsecuritycompliance.googleapis.com/

cloudsupport

Overrides API endpoint for gcloud support command group. Defaults to https://cloudsupport.googleapis.com/

cloudtasks

Overrides API endpoint for gcloud tasks command group. Defaults to https://cloudtasks.googleapis.com/

cloudtrace

Overrides API endpoint for gcloud trace command group. Defaults to https://cloudtrace.googleapis.com/

composer

Overrides API endpoint for gcloud composer command group. Defaults to https://composer.googleapis.com/

compute

Overrides API endpoint for gcloud compute command group. For Private Service Connect usage, see https://cloud.google.com/vpc/docs/configure-private-service-connect-apis#using-endpoints

config

Overrides API endpoint for gcloud infra-manager command group. Defaults to https://config.googleapis.com/

container

Overrides API endpoint for gcloud container command group. Defaults to https://container.googleapis.com/

datacatalog

Overrides API endpoint for gcloud data-catalog command group. Defaults to https://datacatalog.googleapis.com/

dataflow

Overrides API endpoint for gcloud dataflow command group. Defaults to https://dataflow.googleapis.com/

datafusion

Overrides API endpoint for gcloud data-fusion command group. Defaults to https://datafusion.googleapis.com/

datalineage

Overrides API endpoint for gcloud datalineage command group. Defaults to https://datalineage.googleapis.com/

datamigration

Overrides API endpoint for gcloud database-migration command group. Defaults to https://datamigration.googleapis.com/

datapipelines

Overrides API endpoint for gcloud datapipelines command group. Defaults to https://datapipelines.googleapis.com/

dataplex

Overrides API endpoint for gcloud dataplex command group. Defaults to https://dataplex.googleapis.com/

dataproc

Overrides API endpoint for gcloud dataproc command group. Defaults to https://dataproc.googleapis.com/

datastore

Overrides API endpoint for gcloud datastore command group. Defaults to https://datastore.googleapis.com/

datastream

Overrides API endpoint for gcloud datastream command group. Defaults to https://datastream.googleapis.com/

deploymentmanager

Overrides API endpoint for gcloud deployment-manager command group. Defaults to https://deploymentmanager.googleapis.com/

developerconnect

Overrides API endpoint for gcloud developer-connect command group. Defaults to https://developerconnect.googleapis.com/

devicerun

Overrides API endpoint for gcloud device-run command group. Defaults to https://devicerun.googleapis.com/

dns

Overrides API endpoint for gcloud dns command group. Defaults to https://dns.googleapis.com/dns/v1/

domains

Overrides API endpoint for gcloud domains command group. Defaults to https://domains.googleapis.com/

edgecontainer

Overrides API endpoint for gcloud edge-container command group. Defaults to https://edgecontainer.googleapis.com/

eventarc

Overrides API endpoint for gcloud eventarc command group. Defaults to https://eventarc.googleapis.com/

eventarcpublishing

Overrides API endpoint for gcloud eventarc publish command group. Defaults to https://eventarcpublishing.googleapis.com/

faultinjectiontesting

Overrides API endpoint for gcloud fault-injection command group.

faulttesting

Overrides API endpoint for gcloud fault-testing command group. Defaults to https://faulttesting.googleapis.com/

file

Overrides API endpoint for gcloud filestore command group. Defaults to https://file.googleapis.com/

firebasedataconnect

Overrides API endpoint for gcloud firebase-data-connect command group. Defaults to https://firebasedataconnect.googleapis.com/

firestore

Overrides API endpoint for gcloud firestore command group. Defaults to https://firestore.googleapis.com/

ftp

Overrides API endpoint for gcloud storage ftp command group. Defaults to https://ftp.googleapis.com/

genomics

Overrides API endpoint for gcloud genomics command group. Defaults to https://genomics.googleapis.com/

gkemulticloud

Overrides API endpoint for gcloud container aws, gcloud container azure and gcloud container attached command groups.

healthcare

Overrides API endpoint for gcloud healthcare command group. Defaults to https://healthcare.googleapis.com/

hypercomputecluster

Overrides API endpoint for gcloud cluster-director command group. Defaults to https://hypercomputecluster.googleapis.com/

iam

Overrides API endpoint for gcloud iam command group. Defaults to https://iam.googleapis.com/

iamconnectors

Overrides API endpoint for gcloud agent-identity command group. Defaults to https://iamconnectors.googleapis.com/

iamcredentials

Overrides API endpoint for gcloud iam command group. Defaults to https://iamcredentials.googleapis.com/

iap

Overrides API endpoint for gcloud iap command group. Defaults to https://iap.googleapis.com/

ids

Overrides API endpoint for gcloud ids command group. Defaults to https://ids.googleapis.com/

kmsinventory

Overrides API endpoint for gcloud kms inventory command group. Defaults to https://kmsinventory.googleapis.com/

krmapihosting

Overrides API endpoint for gcloud anthos config controller command group. Defaults to https://krmapihosting.googleapis.com/

language

Overrides API endpoint for gcloud ml language command group. Defaults to https://language.googleapis.com/

logging

Overrides API endpoint for gcloud logging command group. Defaults to https://logging.googleapis.com/

looker

Overrides API endpoint for gcloud looker command group. Defaults to https://looker.googleapis.com/

managedidentities

Overrides API endpoint for gcloud active-directory command group. Defaults to https://managedidentities.googleapis.com/

marketplacesolutions

Overrides API endpoint for gcloud mps command group. Defaults to https://marketplacesolutions.googleapis.com/

mediaasset

Overrides API endpoint for gcloud media command group. Defaults to https://mediaasset.googleapis.com/

memcache

Overrides API endpoint for gcloud memcache command group. Defaults to https://memcache.googleapis.com/

metastore

Overrides API endpoint for gcloud metastore command group. Defaults to https://metastore.googleapis.com/

monitoring