AWS Identity and Access Management
User Guide

Actions, Resources, and Condition Keys for AWS Step Functions

AWS Step Functions (service prefix: states) provides the following service-specific resources, actions, and condition context keys for use in IAM permission policies.

References:

Actions Defined by AWS Step Functions

You can specify the following actions in the Action element of an IAM policy statement. By using policies, you define the permissions for anyone performing an operation in AWS. When you use an action in a policy, you usually allow or deny access to the API operation or CLI command with the same name. However, in some cases, a single action controls access to more than one operation. Alternatively, some operations require several different actions. For details about the columns in the following table, see The Actions Table.

Actions Description Access Level Resource Types (*required) Condition Keys Dependent Actions
CreateActivity Creates an activity. Activities must poll Step Functions using the GetActivityTask and respond using SendTask* API calls. Write
CreateStateMachine Creates a state machine. Write
DeleteActivity Deletes an activity. Write

activity*

DeleteStateMachine Deletes a state machine. Write

statemachine*

DescribeActivity Describes an activity. Read

activity*

DescribeExecution Describes an execution. Read

execution*

DescribeStateMachine Describes a state machine. Read

statemachine*

DescribeStateMachineForExecution Describes state machine for an execution. Read

execution*

GetActivityTask Used by workers to retrieve a task (with the specified activity ARN) which has been scheduled for execution by a running state machine. Write

activity*

GetExecutionHistory Returns the history of the specified execution as a list of events. By default, the results are returned in ascending order of the timeStamp of the events. Read

execution*

ListActivities Lists the existing activities. The results may be split into multiple pages. List
ListExecutions Lists the executions of a state machine that meet the filtering criteria. The results may be split into multiple pages. Read

statemachine*

ListStateMachines Lists the existing state machines. The results may be split into multiple pages. List
SendTaskFailure Used by workers to report that the task identified by the taskToken failed. Write
SendTaskHeartbeat Used by workers to report to the service that the task represented by the specified taskToken is still making progress. Write
SendTaskSuccess Used by workers to report that the task identified by the taskToken completed successfully. Write
StartExecution Starts a state machine execution. Write

statemachine*

StopExecution Stops an execution. Write
UpdateStateMachine Updates a state machine. Write

statemachine*

Resources Defined by Step Functions

The following resource types are defined by this service and can be used in the Resource element of IAM permission policy statements. Each action in the Actions table identifies the resource types that can be specified with that action. A resource type can also define which condition keys you can include in a policy. These keys are displayed in the last column of the table. For details about the columns in the following table, see The Resource Types Table.

Resource Types ARN Condition Keys
activity arn:${Partition}:states:${Region}:${Account}:activity:${ActivityName}
execution arn:${Partition}:states:${Region}:${Account}:execution:${StateMachineName}:${ExecutionId}
statemachine arn:${Partition}:states:${Region}:${Account}:stateMachine:${StateMachineName}

Condition Keys for AWS Step Functions

Step Functions has no service-specific context keys that can be used in the Condition element of policy statements. For the list of the global context keys that are available to all services, see Available Keys for Conditions in the IAM Policy Reference.