建立及更新專案標籤

本文詳細說明如何使用 Resource Manager API 和 Google Cloud 控制台，建立及更新專案的標籤。這份指南詳細說明如何使用標籤瞭解費用，以及支援標籤的服務。

為專案建立標籤

控制台

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

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

    開啟「標籤」頁面

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

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

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

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

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

    開啟「Manage resources」(管理資源) 頁面

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

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

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

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

REST

如要建立新專案並為專案加上標籤，請在建立專案時設定 labels 欄位。

要求：

POST https://cloudresourcemanager.googleapis.com/v3/projects

{
 "labels": {
  "color": "red"
 },
 "name": "myproject",
 "projectId": "our-project-123"
}

回應：

{
 "projectNumber": "333197460082",
 "projectId": "our-project-123",
 "lifecycleState": "ACTIVE",
 "name": "myproject",
 "labels": {
  "color": "red"
 },
 "createTime": "2016-01-12T22:18:28.633Z",
}

如要為現有專案加上標籤：

新增標籤後，您就可以根據標籤篩選專案。如要瞭解如何使用標籤篩選專案，請參閱「列出專案」。

更新專案標籤

控制台

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

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

    開啟「標籤」頁面

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

  3. 更新專案的標籤：

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

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

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

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

    開啟「管理資源」頁面

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

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

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

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

REST

如要更新專案的標籤，請按照下列步驟操作：

  • 使用 projects.get() 方法取得 project 物件。

  • 修改要更新的標籤。

  • 呼叫 projects.patch 方法。

以下範例會更新 color:blue 標籤：

以下程式碼片段會將 color 標籤的值從 blue 變更為 red。

要求：

PATCH https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_NAME
{
  updateMask=labels
}

其中 PROJECT_NAME 是要更新的專案名稱。

JSON 要求內文：

{
    "labels":
      {
        "color": "red"
      }
}

回應：

{
    "projects": [
    {
        "name": "projects/123456789012",
        "parent": "folders/123456789012",
        "projectId": "my-project",
        "state": "ACTIVE",
        "displayName": "PROJECT_NAME"
        "createTime": "2013-11-13T20:31:53.308Z"
        "updateTime": "2013-11-13T20:35:42.308Z"
        "etag": "BwWUlZ6XEfY="
        "labels": {
            "color": "red"
        },
    }
    ]
}