建立及更新專案標籤

本文詳細說明如何使用 gcloud CLI、Cloud Resource Manager API 和Google Cloud 控制台，為專案建立及更新標籤。

為專案建立標籤

控制台

如要為單一專案加上標籤：

  1. 在 Google Cloud 控制台中開啟「Labels」(標籤) 頁面。

    開啟「Labels」(標籤) 頁面

  2. 從「Select a project」(選取專案) 下拉式選單中選取專案。

  3. 如要新增標籤項目，請按一下 [+ Add label] (+ 新增標籤)，然後為要新增的每個標籤輸入標籤鍵和值。

  4. 新增完標籤後，請按一下 [Save] (儲存)。

如要同時為多個專案加上標籤：

  1. 在 Google Cloud 控制台中開啟「Manage resources」(管理資源) 頁面。

    開啟「管理資源」頁面

  2. 在「管理資源」頁面中，選取要加上標籤的專案。

  3. 在資訊面板的「Labels」(標籤) 分頁中按一下 [+ Add label] (+ 新增標籤)，並為要新增的每個標籤輸入標籤鍵和值。

  4. 新增完標籤後，請按一下 [Save] (儲存)。

新增完標籤後，您可以在專案列表上方的篩選器方塊中輸入標籤鍵或值，以篩選專案。篩選器方塊會建議標籤鍵或值，方便您預覽結果。

gcloud

如要使用 gcloud CLI 建立新專案並加上標籤，請使用 gcloud projects create 指令並加上 --labels 旗標：

gcloud projects create PROJECT_ID \
    --labels=KEY1=VALUE1,KEY2=VALUE2

如要為現有專案加上標籤，請使用 gcloud projects update 指令並加上 --update-labels 旗標：

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

其中：

  • PROJECT_ID 是您要建立或更新的專案 ID。
  • KEY1=VALUE1 是您要新增的標籤的鍵/值組合。

REST

如要建立新專案並為專案加上標籤，請在對 projects.create 方法發出 POST 要求時，加入 labels 欄位：

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "PROJECT_ID",
    "displayName": "PROJECT_NAME",
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects"

如要為現有專案加上標籤，請使用 projects.patch 方法：

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

更新專案的標籤

控制台

如要更新單一專案的標籤：

  1. 在 Google Cloud 控制台中開啟「Labels」(標籤) 頁面。

    開啟「Labels」(標籤) 頁面

  2. 從「Select a project」(選取專案) 下拉式選單中選取專案。

  3. 更新專案的標籤：

    1. 如要編輯標籤，請點選要編輯的值，然後進行所需變更。
    2. 如要刪除標籤，請將指標懸停在鍵或值上，然後按一下 。

  4. 更新完標籤後，請按一下「儲存」。

如要同時更新多個專案的標籤：

  1. 在 Google Cloud 控制台中開啟「Manage resources」(管理資源) 頁面。

    開啟「管理資源」頁面

  2. 在「管理資源」頁面中，選取要更新標籤的專案。

  3. 在資訊面板中，按一下「標籤」分頁標籤，然後更新所選專案的標籤：

    1. 如要編輯標籤，請點選要編輯的值，然後進行所需變更。
    2. 如要刪除標籤，請將指標懸停在鍵或值上，然後按一下 。

  4. 更新完標籤後，請按一下「儲存」。

gcloud

如要使用 gcloud CLI 更新專案的標籤，請使用 gcloud projects update 指令搭配 --update-labels、--remove-labels 或 --clear-labels 旗標。

如要新增或更新標籤，請按照下列步驟操作：

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

如要移除特定標籤，請按照下列步驟操作：

gcloud projects update PROJECT_ID \
    --remove-labels=KEY1,KEY2

如要移除專案中的所有標籤，請按照下列步驟操作：

gcloud projects update PROJECT_ID \
    --clear-labels

REST

如要使用 API 更新專案的標籤，請將 PATCH 要求傳送至 projects.patch 方法：

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "color": "red"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

其中 PROJECT_ID 是要更新的專案 ID。