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 as the account used by the gcloud CLI for authorization, the default region to use when working with Compute Engine resources, or the option to turn off automatic gcloud CLI component update checks. Properties can also be used to define gcloud CLI preferences like verbosity level and prompt configuration for gcloud CLI commands.
Properties and flags
The gcloud CLI supports some
global flags and command flags that have the same
effect as gcloud CLI properties. For example, the gcloud CLI supports both
--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
A configuration is a named set of
gcloud CLI properties. The gcloud CLI uses a
default as the initial active configuration. The
configuration is suitable for most use cases. However, you can also
create additional configurations and switch between them as required.
gcloud config list
The gcloud CLI returns the list of properties:
[compute] region = us-east1 zone = us-east1-d [core] account = firstname.lastname@example.org disable_usage_reporting = False project = example-project [metrics] command_name = gcloud.config.list
gcloud config set project PROJECT_ID
To set properties that are not in the
properties section, you must specify the section followed by a forward slash
before the property name. The following example sets the zone name to
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
For example, you can set the
compute/zone properties as
To unset a property in the active configuration, use
gcloud config unset:
gcloud config unset disable_usage_reporting
- Read gcloud CLI configurations to learn more about configurations.