管理 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」部分。

後續步驟