Menu
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 Write

activity*

DescribeExecution Describes an execution.

Read Write

execution*

DescribeStateMachine Describes a state machine.

Read Write

statemachine*

DescribeStateMachineForExecution Describes state machine for an execution.

Read Write

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 Write

execution*

ListActivities Lists the existing activities. The results may be split into multiple pages.

List Read Write

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

Read Write

statemachine*

ListStateMachines Lists the existing state machines. The results may be split into multiple pages.

List Read Write

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.