属性是管理 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/project
和 compute/zone
属性:
CLOUDSDK_CORE_PROJECT=[YOUR_PROJECT_NAME]
CLOUDSDK_COMPUTE_ZONE=[YOUR_ZONE_NAME]
取消设置属性
如需在活跃配置中取消设置属性,请使用 gcloud config unset
:
gcloud config unset disable_usage_reporting
可用属性
您可以通过运行 gcloud topic configurations
或 gcloud config set --help
并查找“可用属性”部分来查找所有属性的列表。
后续步骤
- 请参阅
gcloud
CLI 配置以详细了解配置。