Properties are settings that govern the behavior of the gcloud CLI.

You can use properties to define a per-product or per-service setting such asthe account used by the gcloud CLI for authorization, the defaultregion to use when working with Compute Engine resources, or the option toturn off automatic gcloud CLI component update checks. Propertiescan also be used to define gcloud CLI preferences like verbositylevel and prompt configuration for gcloud CLI commands.

Properties and flags

The gcloud CLI supports someglobal flags and command flags that have the sameeffect as gcloud CLI properties. For example, the gcloud CLI supports boththe--project flag andproject property. Properties allow you to maintainthe same settings across command executions while flags affect command behavioron a per-invocation basis. Note that flags override properties when bothare set.

Configurations

Aconfiguration is a named set ofgcloud CLI properties. The gcloud CLI uses aconfiguration nameddefault as the initial active configuration. Thedefaultconfiguration is suitable for most use cases. However, you can alsocreate additional configurations and switch between them as required.

Listing properties

To list the properties in the activeconfiguration, rungcloud config list:

gcloud config list

The gcloud CLI returns the list of properties:

[compute]region = us-east1zone = us-east1-d[core]account = user@google.comdisable_usage_reporting = Falseproject = example-project[metrics]command_name = gcloud.config.list

Setting properties

To set a property in the active configuration, rungcloud config set. The following examplesets theprojectproperty, wherePROJECT_ID is the unique ID for your project.

gcloud config set projectPROJECT_ID

To set properties that are not in thecoreproperties section, you must specify the section followed by a forward slashbefore the property name. The following example sets the zone name tous-east1-b.

gcloud config set compute/zoneus-east1-b

Setting properties using environment variables

You can also set properties using environment variables. Each property has acorresponding environment variable that can be used to set it. The name of theenvironment variable follows theCLOUDSDK_SECTION_NAME_PROPERTY_NAME pattern.For example, you can set thecore/project andcompute/zone properties asfollows:

CLOUDSDK_CORE_PROJECT=PROJECT_NAMECLOUDSDK_COMPUTE_ZONE=ZONE_NAME

Unsetting properties

To unset a property in the active configuration, usegcloud config unset:

gcloud config unset disable_usage_reporting

Available Properties

The list of all properties can be found by runninggcloud topic configurationsorgcloud config set --help and lookingfor the Available Properties section.

What's next

• Readgcloud CLI configurations tolearn more about configurations.