AWS Step Functions のアクション、リソース、および条件キー - サービス認証リファレンス

「翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。」

AWS Step Functions のアクション、リソース、および条件キー

AWS Step Functions (サービスプレフィックス: states) では、IAM アクセス許可ポリシーで使用できるように、以下のサービス固有のリソースやアクション、条件コンテキストキーが用意されています。

参照:

AWS Step Functions で定義されるアクション

IAM ポリシーステートメントの Action 要素では、以下のアクションを指定できます。ポリシーを使用して、AWS でオペレーションを実行するアクセス許可を付与します。ポリシーでアクションを使用する場合は、通常、同じ名前の API オペレーションまたは CLI コマンドへのアクセスを許可または拒否します。ただし、場合によっては、1 つのアクションによって複数のオペレーションへのアクセスが制御されます。あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。

[リソースタイプ] 列は、各アクションがリソースレベルのアクセス許可をサポートしているかどうかを示します。この列に値がない場合は、ポリシーステートメントの Resource 要素ですべてのリソース (「*」) を指定する必要があります。列にリソースタイプが含まれる場合、そのアクションを含むステートメントでそのタイプの ARN を指定できます。必須リソースは、アスタリスク (*) でテーブルに示されています。このアクションを使用してステートメントでリソースレベルのアクセス許可 ARN を指定する場合、このタイプである必要があります。一部のアクションでは、複数のリソースタイプがサポートされています。リソースタイプがオプション (必須として示されていない) の場合、一方を使用することはできますが、他方を使用することはできません。

以下の表の列の詳細については、「アクションテーブル」を参照してください。

アクション 説明 アクセスレベル リソースタイプ (* 必須) 条件キー 依存アクション
CreateActivity アクティビティを作成するアクセス許可を付与します 書き込み

activity*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateStateMachine ステートマシンを作成するアクセス許可を付与します 書き込み

statemachine*

aws:RequestTag/${TagKey}

aws:TagKeys

DeleteActivity アクティビティを削除するアクセス許可を付与します 書き込み

activity*

DeleteStateMachine ステートマシンを削除するアクセス許可を付与します 書き込み

statemachine*

DescribeActivity アクティビティを記述するアクセス許可を付与します Read

activity*

DescribeExecution 実行を記述するアクセス許可を付与します Read

execution*

DescribeStateMachine ステートマシンを記述するアクセス許可を付与します Read

statemachine*

DescribeStateMachineForExecution 実行のためのステートマシンを記述するアクセス許可を付与します Read

execution*

GetActivityTask 実行中のステートマシンによって実行がスケジュールされたタスク (指定されたアクティビティ ARN を持つ) を取得するためにワーカーによって使用されます 書き込み

activity*

GetExecutionHistory 指定された実行の履歴をイベントのリストとして返す許可を付与します Read

execution*

ListActivities 既存のアクティビティを一覧表示するアクセス許可を付与します リスト
ListExecutions ステートマシンの実行を一覧表示するアクセス許可を付与します Read

statemachine*

ListStateMachines 既存のステートマシンを一覧表示するアクセス許可を付与します リスト
ListTagsForResource AWS Step Functions リソースのタグを一覧表示するアクセス許可を付与します Read

activity

statemachine

SendTaskFailure taskToken によって識別されたタスクが失敗したことを報告するアクセス許可を付与します 書き込み
SendTaskHeartbeat 指定された taskToken によって表されるタスクがまだ進行中であることを、サービスに報告するアクセス許可を付与します 書き込み
SendTaskSuccess taskToken によって識別されたタスクが正常に完了したことを報告するアクセス許可を付与します 書き込み
StartExecution ステートマシンの実行を開始するアクセス許可を付与します 書き込み

statemachine*

StartSyncExecution 同期高速状態マシンの実行を開始するアクセス許可を付与します 書き込み

statemachine*

StopExecution 実行を停止するアクセス許可を付与します 書き込み

execution*

TagResource AWS Step Functions リソースにタグを付けるアクセス許可を付与します タグ付け

activity

statemachine

aws:TagKeys

aws:RequestTag/${TagKey}

UntagResource AWS Step Functions リソースからタグを削除するアクセス許可を付与します タグ付け

activity

statemachine

aws:TagKeys

UpdateStateMachine ステートマシンを更新するアクセス許可を付与します 書き込み

statemachine*

aws:RequestTag/${TagKey}

aws:TagKeys

AWS Step Functions で定義されるリソースタイプ

以下のリソースタイプは、このサービスによって定義され、IAM アクセス許可ポリシーステートメントの Resource 要素で使用できます。アクションテーブルの各アクションは、そのアクションで指定できるリソースタイプを示しています。リソースタイプは、ポリシーに含めることができる条件キーを定義することもできます。これらのキーは、テーブルの最後の列に表示されます。以下の表の列の詳細については、「リソースタイプテーブル」を参照してください。

リソースタイプ ARN 条件キー
activity arn:${Partition}:states:${Region}:${Account}:activity:${ActivityName}

aws:ResourceTag/${TagKey}

execution arn:${Partition}:states:${Region}:${Account}:execution:${StateMachineName}:${ExecutionId}
statemachine arn:${Partition}:states:${Region}:${Account}:stateMachine:${StateMachineName}

aws:ResourceTag/${TagKey}

AWS Step Functions の条件キー

AWS Step Functions では、Condition ポリシーの IAM 要素で使用できる以下の条件キーを定義します。これらのキーを使用して、ポリシーステートメントが適用される条件をさらに絞り込むことができます。以下の表の列の詳細については、「条件キーテーブル」を参照してください。

すべてのサービスで使用できるグローバル条件キーを確認するには、使用できるグローバル条件キーを参照してください。

条件キー 説明 タイプ
aws:RequestTag/${TagKey} リクエストで許可されているタグキーと値のペアによってアクセスをフィルタリングします 文字列
aws:ResourceTag/${TagKey} タグキーとリソースの値のペアによってアクセスをフィルタリングします 文字列
aws:TagKeys リクエストで許可されているタグキーのリストによってアクセスをフィルタリングします 文字列