管理 SDK 属性

什么是属性?

属性是用于管理 gcloud CLI 和其他 SDK 工具的行为的设置。

属性可用于定义每个产品或每个服务的设置,例如 gcloud CLI 和其他 Cloud SDK 工具用于授权的帐号,或使用 Google Compute Engine 资源时要使用的默认区域,甚至还包括用于关闭 Cloud SDK 组件自动更新的选项。属性也可用于定义 gcloud 命令行工具偏好设置,比如 gcloud CLI 命令的详尽程度和提示配置。

属性和标志

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

配置

配置是一组指定的 SDK 属性。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 并查找“可用的属性”部分,可查看所有属性的列表。

后续步骤

  • 如需详细了解配置,请参阅 SDK 配置