名稱
gdcloud topic 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
* 如果設定此值，gdcloud CLI 就不會自動檢查更新。
core
* disable_prompts
* 如果為 True，系統會假設所有使用者提示的預設答案。不過，如果提示需要使用者輸入內容，系統就會引發錯誤。
* format
* 設定列印指令輸出資源的格式。預設值為指令專用的易讀輸出格式。如果同時指定 core/format 和 --format，系統會優先採用 --format。支援的格式僅限 csv、json、table、text、yaml。
* organization_console_url
* 目前機構 UI/控制台的網址。請注意，開頭應為 https //console.。例如：https //console.org-name.gdch.google.com。* project
* 目前的專案名稱。
storage
* s3_access_key_id
* S3 儲存空間物件的存取金鑰 ID。這是使用者的專屬 ID。
* s3_custom_ca_certs_file
* S3 儲存物件的自訂憑證檔案。
* s3_endpoint
* S3 物件的網址由 S3_ENDPOINT/$BUCKET_NAME/$OBJECT_NAME 組成。S3_ENDPOINT 是 S3 儲存空間 bucket 所在的位置。
* s3_secret_access_key
* 用於簽署要求的 S3 儲存空間物件私密金鑰。