Managing Cloud SDK properties

Properties are settings that govern the behavior of the gcloud command-line tool and other Cloud SDK tools.

You can use properties to define a per-product or per-service setting such as the account used by the gcloud tool and other Cloud SDK tools for authorization, the default region to use when working with Compute Engine resources, or the option to turn off automatic Cloud SDK component updates. Properties can also be used to define gcloud tool preferences like verbosity level and prompt configuration for gcloud tool commands.

Properties and flags

The gcloud tool supports some global flags and command flags that have the same effect as Cloud SDK properties. For example, the gcloud tool supports both the --project flag and project property. Properties allow you to maintain the same settings across command executions while flags affect command behavior on a per-invocation basis. Note that flags override properties when both are set.

Configurations

A configuration is a named set of Cloud SDK properties. The gcloud tool uses a configuration named default as the initial active configuration; default is suitable for most use cases. However, you can also create additional configurations and switch between them as required.

Listing properties

To list the properties in the active configuration, run gcloud config list:

gcloud config list

The gcloud tool returns the list of properties:

[compute]
region = us-east1
zone = us-east1-d
[core]
account = user@google.com
disable_usage_reporting = False
project = example-project
[metrics]
command_name = gcloud.config.list

Setting properties

To set a property in the active configuration, run gcloud config set:

gcloud config set project [PROJECT]

To set properties that are not in the core properties section, you must specify the section followed by a forward slash before the property name:

gcloud config set compute/zone us-east1-b

Setting properties using environment variables

You can also set properties using environment variables. Each property has a corresponding environment variable that can be used to set it. The name of the environment variable follows the CLOUDSDK_SECTION_NAME_PROPERTY_NAME pattern. For example, you can set the core/project and compute/zone properties as follows:

CLOUDSDK_CORE_PROJECT=[YOUR_PROJECT_NAME]
CLOUDSDK_COMPUTE_ZONE=[YOUR_ZONE_NAME]

Unsetting properties

To unset a property in the active configuration, use gcloud config unset:

gcloud config unset disable_usage_reporting

Available Properties

The list of all properties can be found by running gcloud topic configurations or gcloud config set --help and looking for the Available Properties section.

What's next