標籤

Amazon SWF 支援標記工作流程執行。這一點在擁有許多資源時特別實用。

Amazon SWF 支援使用最多五個標籤來標記工作流程執行。每個標籤都是任意形式的字串，而且最長可能為 256 個字元。如果您想要使用標籤，則必須在啟動工作流程執行時指派它們。您無法在啟動工作流程執行之後將標籤新增至工作流程執行，也無法編輯或移除已指派給工作流程執行的標籤。

IAM 支援根據標籤來控制對 Amazon SWF 網域的存取。若要根據標籤控制存取，請在 IAM 政策的條件 (condition) 元素中，提供您標籤的資訊。

管理標籤

使用 AWS 開發套件或直接與 Amazon SWF API 互動來管理 Amazon 簡單工作流程服務標籤。使用 API，您可以在註冊網域時新增標籤、列出現有網域的標籤，以及新增或刪除現有網域的標籤。

注意

每個資源限制為 50 個標籤。請參閱 Amazon SWF 的一般帳戶配額

• RegisterDomain

• ListTagsForResource

• TagResource

• UntagResource

如需詳細資訊使用 Amazon SWF API，請參閱和 Amazon 簡單工作流程服務 API 參考。

標記工作流程執行

使用 Amazon SWF，您可以將標籤與工作流程執行產生關聯，然後根據這些標籤查詢工作流程執行。您可以在使用可見性作業時篩選 listi。通過仔細選擇分配給執行項目的標籤，您可以使用它們來提供有意義的列表。

例如，假設您執行數個履行中心。使用標籤，您可以列出特定出貨中心中發生的流程。或者，如果客戶要轉換不同類型的媒體文件，則在轉換視頻，音頻和圖像文件時，標籤可能表示不同的過程。

在您使用 StartWorkflowExecution 動作、StartChildWorkflowExecution 決策或 ContinueAsNewWorkflowExecution 決策來啟動工作流程執行時，最多可以將五個標籤關聯至這些工作流程執行。當您使用可見度動作來列出或計算工作流程執行項目時，您可以根據標籤篩選結果。

使用標記

1. 設計標記策略。請考量您的商業需求，並建立對您有意義的標籤清單。判斷哪些執行會取得哪些標籤。即使最多可以將五個標籤指派給執行，您的標籤程式庫還是可以有任意數目的標籤。因為每個標籤可以是任意字串值，最長可達 256 個字元，所以標籤幾乎可以描述任何商業概念。

2. 在您建立執行時，標記執行的上限為最多五個標籤。

3. 使用ListOpenWorkflowExecutions、ListClosedWorkflowExecutions、和CountClosedWorkflowExecutions動作指定 tagFilter 參數，以列出或計算使用特定標籤標記的執行項目。CountOpenWorkflowExecutions動作將根據指定的標籤來篩選執行。

當您建立標籤與工作流程執行的關聯時，標籤便與該執行建立永久的關聯，無法予以移除。

您只能在具有 ListWorkflowExecutions 的 tagFilter 參數中指定一個標籤。另外，標籤比對區分大小寫，因此只會傳回完全相符的項目結果。

假設您已設定如下標記的兩個執行。

執行名稱	指派的標籤
Execution-One	Consumer, 2011-February
Execution-Two	Wholesale, 2011-March

您可以篩選 ListOpenWorkflowExecutions 對於 Consumer (消費者) 標籤所傳回的執行清單。oldestDate 和 latestDate 值指定為 Unix 時間值。

https://swf.us-east-1.amazonaws.com
  RespondDecisionTaskCompleted
  {
    "domain":"867530901",
    "startTimeFilter":{
        "oldestDate":1262332800,
        "latestDate":1325348400
    },
    "tagFilter":{
      "tag":"Consumer"
      }
  }

使用標籤控制網域的存取

您可以在 IAM 中參考與 Amazon SWF 網域關聯的標籤，以控制對 Amazon 簡單工作流程服務網域的存取。例如，您可以限制包含索引鍵所在標籤environment且值為的網域production：

{
      "Version": "2012-10-17",
      "Statement": [
          {
              "Effect": "Deny",
              "Action": "swf:*",
              "Resource": "arn:aws:swf:*:123456789012:/domain/*",
              "Condition": {
                  "StringEquals": {"aws:ResourceTag/environment": "production"}
              }
          }
      ]
  }

此政策將 Deny (拒絕) 對已標記為 environment/production 之任何網域的存取權。

如需詳細資訊，請參閱：

• 使用 IAM 標籤控制存取

• 標籤類型政策