Amazon Step Functions Execution List Item Structure
Contains details about an execution.
Type: objectProperties: 10Required: 5
OrchestrationServerlessState MachineWorkflow
ExecutionListItem is a JSON Structure definition published by Amazon Step Functions, describing 10 properties, of which 5 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
{
"type": "object",
"$schema": "https://json-structure.org/meta/core/v0/#",
"$id": "https://raw.githubusercontent.com/api-evangelist/amazon-step-functions/refs/heads/main/json-structure/amazon-step-functions-execution-list-item-structure.json",
"name": "ExecutionListItem",
"description": "Contains details about an execution.",
"properties": {
"executionArn": {
"allOf": [
{
"$ref": "#/components/schemas/Arn"
},
{
"description": "The Amazon Resource Name (ARN) that identifies the execution."
}
]
},
"stateMachineArn": {
"allOf": [
{
"$ref": "#/components/schemas/Arn"
},
{
"description": "The Amazon Resource Name (ARN) of the state machine that ran the execution."
}
]
},
"name": {
"allOf": [
{
"$ref": "#/components/schemas/Name"
},
{
"description": "<p>The name of the execution.</p> <p>A name must <i>not</i> contain:</p> <ul> <li> <p>white space</p> </li> <li> <p>brackets <code>< > { } [ ]</code> </p> </li> <li> <p>wildcard characters <code>? *</code> </p> </li> <li> <p>special characters <code>\" # % \\ ^ | ~ ` $ & , ; : /</code> </p> </li> <li> <p>control characters (<code>U+0000-001F</code>, <code>U+007F-009F</code>)</p> </li> </ul> <p>To enable logging with CloudWatch Logs, the name should only contain 0-9, A-Z, a-z, - and _.</p>"
}
]
},
"status": {
"allOf": [
{
"$ref": "#/components/schemas/ExecutionStatus"
},
{
"description": "The current status of the execution."
}
]
},
"startDate": {
"allOf": [
{
"$ref": "#/components/schemas/Timestamp"
},
{
"description": "The date the execution started."
}
]
},
"stopDate": {
"allOf": [
{
"$ref": "#/components/schemas/Timestamp"
},
{
"description": "If the execution already ended, the date the execution stopped."
}
]
},
"mapRunArn": {
"allOf": [
{
"$ref": "#/components/schemas/LongArn"
},
{
"description": "The Amazon Resource Name (ARN) of a Map Run. This field is returned only if <code>mapRunArn</code> was specified in the <code>ListExecutions</code> API action. If <code>stateMachineArn</code> was specified in <code>ListExecutions</code>, the <code>mapRunArn</code> isn't returned."
}
]
},
"itemCount": {
"allOf": [
{
"$ref": "#/components/schemas/UnsignedInteger"
},
{
"description": "The total number of items processed in a child workflow execution. This field is returned only if <code>mapRunArn</code> was specified in the <code>ListExecutions</code> API action. If <code>stateMachineArn</code> was specified in <code>ListExecutions</code>, the <code>itemCount</code> field isn't returned."
}
]
},
"stateMachineVersionArn": {
"allOf": [
{
"$ref": "#/components/schemas/Arn"
},
{
"description": "<p>The Amazon Resource Name (ARN) of the state machine version associated with the execution.</p> <p>If the state machine execution was started with an unqualified ARN, it returns null.</p> <p>If the execution was started using a <code>stateMachineAliasArn</code>, both the <code>stateMachineAliasArn</code> and <code>stateMachineVersionArn</code> parameters contain the respective values.</p>"
}
]
},
"stateMachineAliasArn": {
"allOf": [
{
"$ref": "#/components/schemas/Arn"
},
{
"description": "<p>The Amazon Resource Name (ARN) of the state machine alias used to start an execution.</p> <p>If the state machine execution was started with an unqualified ARN or a version ARN, it returns null.</p>"
}
]
}
},
"required": [
"executionArn",
"stateMachineArn",
"name",
"status",
"startDate"
]
}