タグ

Amazon SWF では、ワークフロー実行のタグ付けをサポートしています。これはリソースが多数ある場合に特に便利です。

Amazon SWF は最大 5 つまでのタグ付けとワークフロー実行をサポートします。各タグは自由形式の文字列で、最大 256 文字を使用できます。タグを使用する場合は、ワークフロー実行を開始するときに割り当てる必要があります。開始後にワークフロー実行にタグを追加することはできません。また、ワークフロー実行に割り当てられたタグを編集または削除することもできません。

IAM では、タグに基づく Amazon SWF ドメインのアクセスの制御をサポートしています。タグに基づいてアクセスを制御するには、IAM ポリシーの条件要素でリソースタグに関する情報を指定します。

タグの管理

AWS SDKs を使用するか、Amazon SWF API と直接やり取りして、Amazon Simple Workflow Service タグを管理します。API を使用すると、ドメインの登録時にタグを追加する、既存のドメインでタグを一覧表示する、および既存のドメインでタグを追加または削除することができます。

注記

リソースあたりのタグは 50 個に制限されています。「Amazon SWF の全般アカウントクォータ」を参照してください。

• RegisterDomain

• ListTagsForResource

• TagResource

• UntagResource

詳細については、Amazon SWF API を使用する および「Amazon Simple Workflow Service API Reference」(Amazon Simple Workflow Service API リファレンス) を参照してください。

タグワークフローの実行

Amazon SWF では、タグをワークフロー実行に関連付け、これらのタグに基づいてワークフロー実行をクエリできます。可視性オペレーションを使用すると、リストをフィルタリングできます。実行に割り当てるタグを慎重に選択することで、わかりやすいリストを作成できます。

たとえば、複数のフルフィルメントセンターを運営しているとします。タグを使用すると、特定のフルフィルメントセンターで発生するプロセスを一覧表示できます。または、顧客がさまざまなタイプのメディアファイルを変換している場合、ビデオ、オーディオ、イメージファイルを変換するときに、タグにさまざまなプロセスが示されることがあります。

StartWorkflowExecution アクション、StartChildWorkflowExecution 決定、ContinueAsNewWorkflowExecution 決定を使用して実行を開始すると、最大 5 つのタグをワークフロー実行に関連付けることができます。可視性アクションを使用してワークフロー実行を一覧表示またはカウントする場合、タグに基づいて結果をフィルタリングできます。

タグ付けを使用するには

1. タグ付け戦略を考案します。ビジネス要件について考え、適切なタグのリストを作成します。どの実行がどのタグを取得するかを決定します。実行には最大 5 つのタグを割り当てることができますが、タグライブラリには任意の数のタグを含めることができます。各タグは 256 文字までの任意の文字列値にすることができるため、タグにより、ほぼすべてのビジネスコンセプトを記述できます。

2. 作成時に最大 5 つのタグを使用して実行をタグ付けします。

3. 特定のタグでタグ付けされた実行をリストまたはカウントするには、tagFilter パラメータを ListOpenWorkflowExecutions、ListClosedWorkflowExecutions、CountOpenWorkflowExecutions、および CountClosedWorkflowExecutions アクションで指定します。このアクションでは、指定されたタグに基づいて実行をフィルタリングします。

タグをワークフロー実行に関連付けると、タグはその実行に永続的に関連付けられ、削除することはできません。

ListWorkflowExecutions で tagFilter パラメータに指定できるタグは 1 つのみです。また、タグマッチングでは大文字と小文字が区別され、完全一致の結果のみが返されます。

次のように、タグ付けされた 2 つの実行を既に設定しているとします。

実行名	割り当てられたタグ
Execution-One	Consumer, 2011-February
Execution-Two	Wholesale, 2011-March

Consumer タグの ListOpenWorkflowExecutions によって返された実行のリストをフィルタリングできます。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 Simple Workflow Service ドメインへのアクセスを制御できます。例えば、キーが でenvironment値が であるタグを含むドメインを制限できますproduction。

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

このポリシーでは、environment/production としてタグ付けされているドメインへのアクセスを Deny します。

詳細については、以下を参照してください。

• IAM タグを使用したアクセスの制御

• タグベースのポリシー