AWS Step Functions 的動作、資源和條件索引鍵 - 服務授權參考

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

AWS Step Functions 的動作、資源和條件索引鍵

AWS Step Functions (服務字首:states) 提供下列服務特定的資源、動作和條件內容索引鍵,可用於 IAM 許可政策。

參考資料:

AWS Step Functions 定義的動作

您可在 IAM 政策陳述式的 Action 元素中指定以下動作。使用政策來授予在 AWS中執行操作的許可。在政策中使用動作時,通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過,在某些情況下,單一動作可控制對多個操作的存取。或者,某些操作需要多種不同的動作。

「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值,您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型,則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源,呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource 元素限制資源存取,則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要),則您可以選擇使用其中一種選用資源類型。

「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊,請參閱「資源類型」資料表的條件索引鍵欄。

注意

資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄,其中包含套用至「動作」資料表中動作的資源條件索引鍵。

如需下表各欄的詳細資訊,請參閱動作資料表

動作 描述 存取層級 資源類型 (*必填項目) 條件索引鍵 相依動作
CreateActivity 准許建立活動 寫入

activity*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateStateMachine 准許建立狀態機器 寫入

statemachine*

iam:PassRole

states:PublishStateMachineVersion

aws:RequestTag/${TagKey}

aws:TagKeys

CreateStateMachineAlias 准許建立狀態機器別名 寫入

statemachine*

states:StateMachineQualifier

DeleteActivity 准許刪除活動 寫入

activity*

DeleteStateMachine 准許刪除狀態機器 寫入

statemachine*

DeleteStateMachineAlias 准許刪除狀態機器別名 寫入

statemachine*

states:StateMachineQualifier

DeleteStateMachineVersion 准許刪除狀態機器版本 寫入

statemachine*

states:StateMachineQualifier

DescribeActivity 准許描述活動 讀取

activity*

DescribeExecution 准許描述執行 讀取

execution*

express*

DescribeMapRun 准許描述映射執行 讀取

maprun*

DescribeStateMachine 准許描述狀態機器 讀取

statemachine*

states:StateMachineQualifier

DescribeStateMachineAlias 准許描述狀態機器別名 讀取

statemachine*

states:StateMachineQualifier

DescribeStateMachineForExecution 准許描述執行的狀態機器 讀取

execution*

GetActivityTask 准許工作者用於擷取已透過執行狀態機器排定要執行的任務 (含指定活動 ARN) 寫入

activity*

GetExecutionHistory 准許傳回指定執行的歷史記錄作為事件清單 讀取

execution*

InvokeHTTPEndpoint [僅限許可] 准許調用 HTTP 任務狀態 寫入
ListActivities 准許列出現有活動 列出
ListExecutions 准許列出狀態機器的執行 清單

maprun*

statemachine*

states:StateMachineQualifier

ListMapRuns 准許列出執行的映射執行 清單

execution*

ListStateMachineAliases 准許列出狀態機器別名 清單

statemachine*

states:StateMachineQualifier

ListStateMachineVersions 准許列出狀態機器版本 清單

statemachine*

ListStateMachines 准許列出現有的狀態機器 清單
ListTagsForResource 准許列出 AWS Step Functions 資源的標籤 清單

activity

statemachine

PublishStateMachineVersion 准許發布狀態機器版本 寫入

statemachine*

RedriveExecution 准許再驅動執行 寫入

execution*

RevealSecrets [僅限許可] 准許從執行揭露敏感資料 讀取
SendTaskFailure 准許報告 taskToken 識別的任務是否失敗 寫入
SendTaskHeartbeat 准許向服務報告指定 taskToken 表示的任務仍有進展 寫入
SendTaskSuccess 准許報告 taskToken 識別的任務是否順利完成 寫入
StartExecution 准許啟動狀態機器執行 寫入

statemachine*

states:StateMachineQualifier

StartSyncExecution 准許啟動 Synchronous Express 狀態機器執行 寫入

statemachine*

states:StateMachineQualifier

StopExecution 准許停止執行 寫入

execution*

TagResource 准許標記 AWS Step Functions 資源 標記

activity

statemachine

aws:TagKeys

aws:RequestTag/${TagKey}

TestState 准許測試狀態機器定義 寫入

states:RevealSecrets

UntagResource 准許從 AWS Step Functions 資源中移除標籤 標記

activity

statemachine

aws:TagKeys

UpdateMapRun 准許更新映射執行 寫入

maprun*

UpdateStateMachine 准許更新狀態機器 寫入

statemachine*

iam:PassRole

states:PublishStateMachineVersion

aws:RequestTag/${TagKey}

aws:TagKeys

UpdateStateMachineAlias 准許更新狀態機器別名 寫入

statemachine*

states:StateMachineQualifier

ValidateStateMachineDefinition 准許驗證狀態機器定義 讀取

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}

aws:ResourceTag/${TagKey}

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

aws:ResourceTag/${TagKey}

statemachineversion arn:${Partition}:states:${Region}:${Account}:stateMachine:${StateMachineName}:${StateMachineVersionId}
statemachinealias arn:${Partition}:states:${Region}:${Account}:stateMachine:${StateMachineName}:${StateMachineAliasName}
maprun arn:${Partition}:states:${Region}:${Account}:mapRun:${StateMachineName}/${MapRunLabel}:${MapRunId}
labelled execution arn:${Partition}:states:${Region}:${Account}:execution:${StateMachineName}/${MapRunLabel}:${ExecutionId}
labelled express arn:${Partition}:states:${Region}:${Account}:express:${StateMachineName}/${MapRunLabel}:${ExecutionId}:${ExpressId}

AWS Step Functions 的條件索引鍵

AWS Step Functions 定義下列條件索引鍵,可用於 IAM 政策的 Condition元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊,請參閱條件索引鍵表

若要檢視所有服務都可使用的全域條件鍵,請參閱可用全域條件鍵

條件索引鍵 描述 類型
aws:RequestTag/${TagKey} 依在請求中允許的標籤索引鍵和值對篩選存取 字串
aws:ResourceTag/${TagKey} 依資源的標籤索引鍵和值對篩選存取 字串
aws:TagKeys 依在請求中允許的標籤索引鍵清單篩選存取 ArrayOfString
states:HTTPEndpoint 依 HTTP 任務狀態在請求中允許的端點來篩選存取權 字串
states:HTTPMethod 依 HTTP 任務狀態在請求中允許的方法來篩選存取權 字串
states:StateMachineQualifier 依狀態機器 ARN 的限定詞篩選存取權 ArrayOfString