名称
gdcloud topic configurations - Supplementary help for named configurations.
说明
gdcloud CLI 属性可以存储在命名配置中，这些配置是键值对的集合，会影响 gdcloud CLI 的行为。
如果您管理多个项目或组织，命名配置会很有用。
配置中通常存储的属性包括组织控制台网址和项目 ID。您可以通过配置，将这些属性及其他设置作为一个组同时定义并启用。
配置数据存储在 $HOME/.config/gdcloud/ 中。
如果您执行以下操作，配置会特别有用：
+ 处理多个项目。您可以为每个项目创建单独的配置。
- 使用多个组织控制台网址。
* 执行通常具有独立性的任务 例如，您可以使用一种配置来处理一个项目中的对象存储服务，并在另一个项目中管理不相关的服务。
所有 gcloud CLI 命令都可以读取存储在指定配置中的属性信息。如需设置属性，请使用 gdcloud config set 命令。
创建配置
命名配置可由用户定义，也可内置于 gdcloud CLI 中。
用户定义的配置具有小写名称，例如 johndoe、default、jeff-staging 或 foo2。这些变量由以下正则表达式 ^[a-z][-a-z0-9]*$ 定义。
如需创建新配置，请运行
gdcloud init
本指南将引导您设置第一个命名配置、创建新的命名配置或重新初始化现有命名配置。请注意，重新初始化现有配置会移除其所有现有属性。
如需创建新的空配置，请运行
gdcloud config configurations create [CONFIG_NAME]
使用配置
gdcloud CLI 最多只能有一个提供属性值的有效配置。非活跃配置对 gdcloud CLI 执行没有任何影响。 如需激活配置，请运行以下命令：
gdcloud config configurations activate [CONFIG_NAME]
如需查看和更改活跃配置的属性，请运行以下命令：
gdcloud config list
gdcloud config set
此外，gdcloud config configurations 组下的命令可让您列出、激活、重命名、描述和删除可能处于有效状态或可能未处于有效状态的配置。
您可以使用标志 --configuration my-config 为单个 gdcloud 调用激活配置。
可用的属性
accessibility
* screen_reader
* 如果设置，gdcloud CLI 会激活屏幕阅读器。
auth
* login_config_cert_path
* 存储当前登录配置证书的文件的路径。
component_manager
* disable_update_check
* 如果设置，gcloud CLI 不会自动检查更新。
core
* disable_prompts
* 如果为 True，则假定所有用户提示的默认答案。不过，对于需要用户输入的任何提示，系统都会引发错误。
* format
* 设置用于打印命令输出资源的格式。默认值为特定于命令的人类可读输出格式。如果同时指定了 core/format 和 --format，则以 --format 为准。支持的格式仅限于 csv、json、table、text、yaml。* organization_console_url
* 当前组织界面/控制台的网址。请注意，它应以 https //console. 开头。例如，https //console.org-name.gdch.google.com。
* project
* 当前项目名称。
storage
* s3_access_key_id
* S3 存储对象的访问密钥 ID。它是用户的唯一标识符。
* s3_custom_ca_certs_file
* S3 存储对象的自定义证书文件。
* s3_endpoint
* S3 对象的网址由 S3_ENDPOINT/$BUCKET_NAME/$OBJECT_NAME 组成。S3_ENDPOINT 是 S3 存储桶所在的位置。
* s3_secret_access_key
* 用于签署请求的 S3 存储对象的私钥。