管理 Cloud SDK 属性

属性是用于控制 gcloud 命令行工具和其他 Cloud SDK 工具的行为的设置。

您可以使用属性来定义每个产品或每个服务的设置,例如 gcloud 工具和其他 Cloud SDK 工具用于授权的帐号,使用 Compute Engine 资源时要使用,或者用于关闭 Cloud SDK 组件自动更新的选项。属性也可用于定义 gcloud 工具偏好设置,比如 gcloud 工具命令的详尽程度和提示配置。

属性和标志

gcloud 工具支持一些全局标志和命令标志,这些标志与 Cloud SDK 属性具有相同的效果。例如,gcloud 工具支持 --project 标志和 project 属性。属性允许您在执行各个命令时保持相同的设置,而标志对命令行为的影响将视调用而定。请注意,在同时设置两者时,标志的优先级高于属性。

配置

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

列出属性

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

gcloud config list

gcloud 工具会返回属性列表:

[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 并查找“可用的属性”部分,可查看所有属性的列表。

后续步骤