管理 gcloud CLI 属性

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

您可以使用属性来定义每个产品或每个服务的设置,例如 gcloud CLI 用于授权的账号、使用 Compute Engine 资源时要使用的默认区域,或者用于关闭自动 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。以下示例设置了 project 属性,其中 PROJECT_ID 是项目的唯一 ID。

gcloud config set project PROJECT_ID

如需设置 core 属性部分之外的属性,您必须先指定相应部分,后跟一个正斜杠,然后再指定属性名称。以下示例将区域名称设置为 us-east1-b

gcloud config set compute/zone us-east1-b

使用环境变量设置属性

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

CLOUDSDK_CORE_PROJECT=PROJECT_NAME

CLOUDSDK_COMPUTE_ZONE=ZONE_NAME

取消设置属性

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

gcloud config unset disable_usage_reporting

可用的属性

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

后续步骤