states:ListExecutions

List

states:ListExecutions is a List access-level action in the states service. Grants permission to list the executions of a state machine

Resource types

ARNs that states:ListExecutions can be scoped to in an IAM policy.

arn:${Partition}:states:${Region}:${Account}:mapRun:${StateMachineName}/${MapRunLabel}:${MapRunId}

maprun

arn:${Partition}:states:${Region}:${Account}:stateMachine:${StateMachineName}

statemachine

Condition keys

Keys you can use in the Condition block of a policy that grants states:ListExecutions.

aws:ResourceTag/${TagKey} String

Filters access by a tag key and value pair of a resource

Example IAM policy

A minimal policy that allows states:ListExecutions. Replace "Resource": "*" with a specific ARN to follow least privilege.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowStatesListExecutions",
      "Effect": "Allow",
      "Action": "states:ListExecutions",
      "Resource": "*"
    }
  ]
}

Related actions in states

states:CreateActivity Write states:CreateStateMachine Write states:CreateStateMachineAlias Write states:DeleteActivity Write states:DeleteStateMachine Write states:DeleteStateMachineAlias Write states:DeleteStateMachineVersion Write states:DescribeActivity Read states:DescribeExecution Read states:DescribeMapRun Read states:DescribeStateMachine Read states:DescribeStateMachineAlias Read

View all states actions →