AWS Step Functions

List executions

List all executions of a state machine by specifying a state machine Amazon Resource Name (ARN).

Inputs

Field

Type

Description

region [required]

enum

default: us-east-1

stateMachineArn [required]

string

The Amazon Resource Name (ARN) of the state machine whose executions are listed.

maxResults

number

The maximum number of results that are returned per call. The default is 100 and the maximum allowed page size is 1000. A value of 0 uses the default.

default: 100

statusFilter

enum

If specified, only list the executions whose current execution status matches the given filter. Allowed enum values: RUNNING,SUCCEEDED,FAILED,TIMED_OUT,ABORTED

Outputs

Expand All

Field

Type

Description

executions [required]

[object]

The list of matching executions.

executionArn [required]

string

The Amazon Resource Name (ARN) that identifies the execution.

stateMachineArn [required]

string

The Amazon Resource Name (ARN) of the executed state machine.

name [required]

string

The name of the execution. A name must not contain: white space brackets < > { } [ ] wildcard characters ? * special characters " # % \ ^ | ~ ` $ & , ; : / control characters (U+0000-001F, U+007F-009F) To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.

status [required]

string

The current status of the execution.

startDate [required]

date-time

The date the execution started.

stopDate

date-time

If the execution already ended, the date the execution stopped.