管理 gcloud CLI 屬性

屬性是控管 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。以下範例會設定 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，然後尋找「Available Properties」部分。

後續步驟