AWS::States::Execution

States Execution

Represents an AWS Step Functions state machine execution.

Properties

3 configurable properties. 1 required. Click a row to see details.

Filter:

Property	Type	Flags
`StateMachineArn`	`string`	RequiredCreate-only
`Input`	`string`	Create-only
`Name`	`string`	Create-only

Return Values

Values returned after the resource is created. Access these with Fn::GetAtt.

Attribute	Type	Description
`ExecutionArn`	`string`	The Amazon Resource Name (ARN) that identifies the execution.
`RedriveCount`	`integer`	The number of times the execution has been redriven.
`RedriveStatus`	`string`	Indicates whether or not an execution can be redriven.
`StartDate`	`string`	The date the execution started.
`StateMachineName`	`string`	The name of the state machine, extracted from the execution ARN.
`Status`	`string`	The current status of the execution.

Sample CloudFormation Template

A minimal template with required properties and common optional ones.

template.yaml

AWSTemplateFormatVersion: "2010-09-09"
Description: Sample template for AWS::States::Execution

Resources:
  MyResource:
    Type: AWS::States::Execution
    Properties:
      StateMachineArn: "arn:aws:service:region:account:resource"
      Name: !Ref "AWS::StackName"

Required IAM Permissions

Permissions CloudFormation needs in your IAM role to manage this resource.

read

states:DescribeExecution

list

states:ListExecutions

Learn AWS the Practical Way

Our bi-weekly newsletter teaches hands-on AWS fundamentals. No certification fluff - just practical knowledge.

Subscribe to Newsletter

Quick Facts

ServiceStates

Properties9

Required1

TaggingNot supported

Primary IDExecutionArn

Supported Operations

ReadList

Immutable After Creation

These properties cannot be changed after the resource is created. Updating them triggers a replacement.

InputNameStateMachineArn

External Links

AWS Documentation