管理 gcloud CLI 属性

属性是管理 gcloud CLI 行为的设置。

您可以使用属性来定义每个产品或服务的设置,例如 gcloud CLI 用于授权的帐号、处理 Compute Engine 资源时要使用的默认区域,或用于关闭自动 gcloud CLI 组件更新检查的选项。属性还可用于定义 gcloud CLI 偏好设置,例如 gcloud CLI 命令的详尽程度和提示配置。

属性和标志

gcloud CLI 支持一些全局标志和命令标志,这些标志的效果与 gcloud CLI 属性相同。例如,gcloud CLI 支持 --project 标志和 project 属性。利用属性,您可以在每次执行命令时保持相同的设置,而标志对于每次调用时都会影响命令行为。请注意,如果同时设置了两者,则标记会替换属性。

配置

配置是一组指定的 gcloud CLI 属性。gcloud CLI 使用名为 default 的配置作为初始活跃配置。default 配置适用于大多数使用场景。但是,您也可以创建其他配置并根据需要在配置之间切换。

列出属性

如需列出活跃配置中的属性,请运行 gcloud config list

gcloud config list

gcloud CLI 会返回属性列表:

[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

设置属性

如需在活跃配置中设置属性,请运行 gcloud config set

gcloud config set project [PROJECT]

如需设置 core 属性部分之外的属性,您必须在属性名称前面指定后跟正斜杠的部分:

gcloud config set compute/zone us-east1-b

使用环境变量设置属性

您还可以使用环境变量设置属性。每个属性都有一个可用于设置的对应环境变量。环境变量的名称遵循 CLOUDSDK_SECTION_NAME_PROPERTY_NAME 模式。例如,您可以按如下方式设置 core/projectcompute/zone 属性:

CLOUDSDK_CORE_PROJECT=[YOUR_PROJECT_NAME]

CLOUDSDK_COMPUTE_ZONE=[YOUR_ZONE_NAME]

取消设置属性

如需在活跃配置中取消设置属性,请使用 gcloud config unset

gcloud config unset disable_usage_reporting

可用属性

您可以通过运行 gcloud topic configurationsgcloud config set --help 并查找“可用属性”部分来查找所有属性的列表。

后续步骤