標籤工作流程

標籤是鍵/值組合，可用於識別及分組相關工作流程，並儲存工作流程的中繼資料。您可以為工作流程指定多個標籤。

本頁面說明如何在工作流程中使用標籤。並說明如何新增、更新及移除工作流程的標籤。

如要將 Google Cloud 工作流程和其他資源分組，以便在 Google Cloud 貴機構中進行報表、稽核和存取權控管，請使用標記。標記和標籤各自獨立運作，您可以將兩者套用至同一個工作流程。

什麼是標籤？

標籤是鍵/值組合，可指派給 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 呼叫的個別值建立標籤。這種做法的問題是，如果值經常變更，或鍵會使目錄變得雜亂，就很難有效篩選及回報資源。

標籤

標籤可用做為可查詢的資源註解，但無法用於設定政策條件。您可將資源是否具備特定標記設為條件，並按照這項條件允許或拒絕政策。詳情請參閱「標記總覽」。

新增或更新標籤

建立工作流程時，您可以為工作流程新增一或多個標籤。您也可以在更新工作流程時新增或編輯標籤。

如果您更新現有標籤或新增標籤，新標籤可能需要最多 10 分鐘才會生效。

依標籤篩選工作流程

您可以依標籤篩選特定工作流程，以便搜尋及列出這些工作流程。

主控台

  1. 前往 Google Cloud 控制台的「Workflows」頁面：

    前往「Workflows」頁面

  2. 在 「Filter」欄位中，選取「Labels」做為篩選條件，然後在「Values」清單中選取索引鍵-值組合。

gcloud

請使用 --filter 旗標搭配 gcloud workflows list 指令：

gcloud workflows list \
    --filter labels.KEY=VALUE

將 KEY 和 VALUE 替換為標籤鍵/值組合。

如要進一步瞭解 Google Cloud CLI 中的篩選器語法，請參閱 gcloud topic filters。

工作流程標籤會沿用工作流程執行作業。如要查看執行標籤，請使用 workflows.executions.list 方法列出並篩選工作流程執行作業。

刪除標籤

您可以使用 Google Cloud 主控台刪除特定標籤，也可以使用 gcloud CLI 刪除工作流程中的所有標籤。

主控台

  1. 前往 Google Cloud 控制台的「Workflows」頁面：

    前往「Workflows」頁面

  2. 按一下要更新的工作流程名稱。

    系統隨即會顯示「工作流程詳細資料」頁面。

  3. 按一下「編輯」圖示 。

    系統隨即會顯示「Edit workflow」(編輯工作流程) 頁面。

  4. 找出要移除的標籤，然後按一下旁邊的 「刪除項目」圖示 。

  5. 點按「Next」。

  6. 如要重新部署工作流程，請按一下「部署」。

gcloud

使用 --labels 標記搭配空值和 gcloud workflows deploy 指令：

gcloud workflows deploy WORKFLOW_NAME \
    --labels="" \
    --source=YAML_OR_JSON_SOURCE_FILE

更改下列內容：

  • WORKFLOW_NAME：工作流程名稱。

  • YAML_OR_JSON_SOURCE_FILE：工作流程的來源檔案，格式為 YAML 或 JSON。例如：myFirstWorkflow.yaml。