本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
AWS Step Functions 的動作、資源和條件索引鍵
AWS Step Functions (服務字首:states
) 提供下列服務特定的資源、動作和條件內容索引鍵,可用於 IAM 許可政策。
參考資料:
-
了解如何設定此服務。
-
檢視可供此服務使用的 API 操作清單。
-
了解如何使用 IAM 許可政策來保護此服務及其資源。
AWS Step Functions 定義的動作
您可在 IAM 政策陳述式的 Action
元素中指定以下動作。使用政策來授予在 AWS中執行操作的許可。在政策中使用動作時,通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過,在某些情況下,單一動作可控制對多個操作的存取。或者,某些操作需要多種不同的動作。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值,您必須在政策陳述式的 Resource
元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型,則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源,呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource
元素限制資源存取,則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要),則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition
元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊,請參閱「資源類型」資料表的條件索引鍵欄。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄,其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊,請參閱動作資料表。
動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
---|---|---|---|---|---|
CreateActivity | 准許建立活動 | 寫入 | |||
CreateStateMachine | 准許建立狀態機器 | 寫入 |
iam:PassRole states:PublishStateMachineVersion |
||
CreateStateMachineAlias | 准許建立狀態機器別名 | 寫入 | |||
DeleteActivity | 准許刪除活動 | 寫入 | |||
DeleteStateMachine | 准許刪除狀態機器 | 寫入 | |||
DeleteStateMachineAlias | 准許刪除狀態機器別名 | 寫入 | |||
DeleteStateMachineVersion | 准許刪除狀態機器版本 | 寫入 | |||
DescribeActivity | 准許描述活動 | 讀取 | |||
DescribeExecution | 准許描述執行 | 讀取 | |||
DescribeMapRun | 准許描述映射執行 | 讀取 | |||
DescribeStateMachine | 准許描述狀態機器 | 讀取 | |||
DescribeStateMachineAlias | 准許描述狀態機器別名 | 讀取 | |||
DescribeStateMachineForExecution | 准許描述執行的狀態機器 | 讀取 | |||
GetActivityTask | 准許工作者用於擷取已透過執行狀態機器排定要執行的任務 (含指定活動 ARN) | 寫入 | |||
GetExecutionHistory | 准許傳回指定執行的歷史記錄作為事件清單 | 讀取 | |||
InvokeHTTPEndpoint [僅限許可] | 准許調用 HTTP 任務狀態 | 寫入 | |||
ListActivities | 准許列出現有活動 | 列出 | |||
ListExecutions | 准許列出狀態機器的執行 | 清單 | |||
ListMapRuns | 准許列出執行的映射執行 | 清單 | |||
ListStateMachineAliases | 准許列出狀態機器別名 | 清單 | |||
ListStateMachineVersions | 准許列出狀態機器版本 | 清單 | |||
ListStateMachines | 准許列出現有的狀態機器 | 清單 | |||
ListTagsForResource | 准許列出 AWS Step Functions 資源的標籤 | 清單 | |||
PublishStateMachineVersion | 准許發布狀態機器版本 | 寫入 | |||
RedriveExecution | 准許再驅動執行 | 寫入 | |||
RevealSecrets [僅限許可] | 准許從執行揭露敏感資料 | 讀取 | |||
SendTaskFailure | 准許報告 taskToken 識別的任務是否失敗 | 寫入 | |||
SendTaskHeartbeat | 准許向服務報告指定 taskToken 表示的任務仍有進展 | 寫入 | |||
SendTaskSuccess | 准許報告 taskToken 識別的任務是否順利完成 | 寫入 | |||
StartExecution | 准許啟動狀態機器執行 | 寫入 | |||
StartSyncExecution | 准許啟動 Synchronous Express 狀態機器執行 | 寫入 | |||
StopExecution | 准許停止執行 | 寫入 | |||
TagResource | 准許標記 AWS Step Functions 資源 | 標記 | |||
TestState | 准許測試狀態機器定義 | 寫入 |
states:RevealSecrets |
||
UntagResource | 准許從 AWS Step Functions 資源中移除標籤 | 標記 | |||
UpdateMapRun | 准許更新映射執行 | 寫入 | |||
UpdateStateMachine | 准許更新狀態機器 | 寫入 |
iam:PassRole states:PublishStateMachineVersion |
||
UpdateStateMachineAlias | 准許更新狀態機器別名 | 寫入 | |||
ValidateStateMachineDefinition | 准許驗證狀態機器定義 | 讀取 |
AWS Step Functions 定義的資源類型
此服務會定義下列資源類型,並可用在 IAM 許可政策陳述式的 Resource
元素中。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊,請參閱資源類型資料表。
資源類型 | ARN | 條件索引鍵 |
---|---|---|
activity |
arn:${Partition}:states:${Region}:${Account}:activity:${ActivityName}
|
|
execution |
arn:${Partition}:states:${Region}:${Account}:execution:${StateMachineName}:${ExecutionId}
|
|
express |
arn:${Partition}:states:${Region}:${Account}:express:${StateMachineName}:${ExecutionId}:${ExpressId}
|
|
statemachine |
arn:${Partition}:states:${Region}:${Account}:stateMachine:${StateMachineName}
|
|
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 |