本頁面由 Cloud Translation API 翻譯而成。

為 Cloud Workstations 資源加上標籤

本頁面說明如何搭配使用標籤與 Cloud Workstations 資源。

什麼是標籤？

標籤是可指派給 Google Cloud 執行個體的鍵/值組合。這些工具可協助您整理資源，並以所需的精細程度大規模管理費用。您可以為每一項資源加上標籤，並根據標籤來篩選資源。標籤資訊會轉送至帳單系統，方便您按標籤查看帳單費用明細。透過內建的帳單報表，您可以依資源標籤篩選及分組費用。您也可以使用標籤查詢帳單資料匯出內容。

標籤需求

套用於資源的標籤必須符合下列需求條件：

每項資源最多可以有 64 個標籤。
每個標籤都必須是鍵/值組合。
鍵的長度必須至少為 1 個字元，最多 63 個字元，且不能空白。值可以空白，長度上限為 63 個字元。
鍵和值只能使用小寫字母、數字字元、底線和連字號。所有字元都必須使用 UTF-8 編碼，且可使用國際字元。鍵的開頭必須是小寫字母或國際字元。
標籤中的鍵部分在單一資源內不得重複。但可讓多個資源使用相同的鍵。

這些限制適用於每個標籤的鍵和值，以及具有標籤的個別 Google Cloud 資源。專案中所有資源可套用的標籤數量沒有上限。

標籤的常見用法

以下是一些常見的標籤用途：

團隊或成本中心標籤：依據團隊或成本中心來新增標籤，藉此區別不同團隊 (例如 team:research 和 team:analytics) 擁有的執行個體。這個類型的標籤可用於成本會計或預算編列作業。
元件標籤：例如 component:redis、component:frontend、component:ingest 和 component:dashboard。
環境或階段標籤：例如 environment:production 和 environment:test。
狀態標籤：例如 state:active、state:readytodelete 和 state:archive。
擁有權標籤：用來識別負責作業的團隊，例如：team:shopping-cart。

+ 虛擬機器標籤：可附加至虛擬機器的標籤。您過去定義的虛擬機器標籤會顯示為沒有值的標籤。

我們不建議您建立大量的不重複標籤，例如幫時間戳記或每個 API 呼叫的個別值建立標籤。這種做法的問題在於，如果值經常變更，或使用會使目錄雜亂的鍵，就難以有效篩選及回報資源。

Cloud Workstations 資源標籤

Cloud Workstations 會自動將下列標籤套用至所有資源：

workstation_cluster_id
workstation_config_id
workstation_id
workstation_location
goog-drz-workstation-location
goog-drz-workstation-uuid
goog-workstations

自訂 Cloud Workstations 標籤

您也可以將自訂標籤新增至工作站叢集、工作站設定和工作站，並以遞迴方式將標籤套用至所有基礎 Compute Engine 資源，但不會套用至基礎 Cloud Workstations API 資源。如要為個別工作站標記 Compute Engine 資源，請務必為每個工作站新增標籤。

呼叫 Cloud Workstations API 時，請使用 labels 欄位。

舉例來說，在下方的 config.json 範例檔案中，webserver 是鍵，backend 則是對應的值。同樣地，media 是鍵，images 則是對應的值。

    {
      "idleTimeout": "7200s",
      "host": {
        "gce_instance": {
          "machine_type": "e2-standard-8",
          "pool_size": 1
        }
      },
      "persistentDirectories": [
        {
        "mountPath": "/home",
        "gcePd": {
          "sizeGb": 200,
          "fsType": "ext4"
        }
      }
      ],
      "labels": {
        "webserver": "backend",
        "media": "images"
      }
    }