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