execution_histories
Creates, updates, deletes, gets or lists an execution_histories resource.
Overview
| Name | execution_histories |
| Type | Resource |
| Id | aws.stepfunctions.execution_histories |
Fields
The following fields are returned by SELECT queries:
- get_execution_history
| Name | Datatype | Description |
|---|---|---|
id | integer (int64) | The id of the event. Events are numbered sequentially, starting at one. |
activity_failed_event_details | object | Contains details about an activity that failed during an execution. |
activity_schedule_failed_event_details | object | Contains details about an activity schedule event that failed during an execution. |
activity_scheduled_event_details | object | Contains details about an activity scheduled during an execution. |
activity_started_event_details | object | Contains details about the start of an activity during an execution. |
activity_succeeded_event_details | object | Contains details about an activity that successfully terminated during an execution. |
activity_timed_out_event_details | object | Contains details about an activity timeout that occurred during an execution. |
evaluation_failed_event_details | object | Contains details about an evaluation failure that occurred while processing a state. |
execution_aborted_event_details | object | Contains details about an abort of an execution. |
execution_failed_event_details | object | Contains details about an execution failure event. |
execution_redriven_event_details | object | Contains details about the redrive attempt of an execution. |
execution_started_event_details | object | Contains details about the start of the execution. |
execution_succeeded_event_details | object | Contains details about the successful termination of the execution. |
execution_timed_out_event_details | object | Contains details about the execution timeout that occurred during the execution. |
lambda_function_failed_event_details | object | Contains details about a Lambda function that failed during an execution. |
lambda_function_schedule_failed_event_details | object | Contains details about a failed Lambda function schedule event that occurred during an execution. |
lambda_function_scheduled_event_details | object | Contains details about a Lambda function scheduled during an execution. |
lambda_function_start_failed_event_details | object | Contains details about a lambda function that failed to start during an execution. |
lambda_function_succeeded_event_details | object | Contains details about a Lambda function that terminated successfully during an execution. |
lambda_function_timed_out_event_details | object | Contains details about a Lambda function timeout that occurred during an execution. |
map_iteration_aborted_event_details | object | Contains details about an iteration of a Map state that was aborted. |
map_iteration_failed_event_details | object | Contains details about an iteration of a Map state that failed. |
map_iteration_started_event_details | object | Contains details about an iteration of a Map state that was started. |
map_iteration_succeeded_event_details | object | Contains details about an iteration of a Map state that succeeded. |
map_run_failed_event_details | object | Contains error and cause details about a Map Run that failed. |
map_run_redriven_event_details | object | Contains details about the redrive attempt of a Map Run. |
map_run_started_event_details | object | Contains details, such as mapRunArn, and the start date and time of a Map Run. mapRunArn is the Amazon Resource Name (ARN) of the Map Run that was started. |
map_state_started_event_details | object | Contains details about Map state that was started. |
previous_event_id | integer (int64) | The id of the previous event. |
state_entered_event_details | object | Contains details about a state entered during an execution. |
state_exited_event_details | object | Contains details about an exit from a state during an execution. |
task_failed_event_details | object | Contains details about the failure of a task. |
task_scheduled_event_details | object | Contains details about a task that was scheduled. |
task_start_failed_event_details | object | Contains details about a task that failed to start. |
task_started_event_details | object | Contains details about a task that was started. |
task_submit_failed_event_details | object | Contains details about a task that where the submit failed. |
task_submitted_event_details | object | Contains details about a submitted task. |
task_succeeded_event_details | object | Contains details about a task that succeeded. |
task_timed_out_event_details | object | Contains details about a task that timed out. |
timestamp | string (date-time) | The date and time the event occurred, expressed in seconds and fractional milliseconds since the Unix epoch, which is defined as January 1, 1970, at 00:00:00 Coordinated Universal Time (UTC). |
type_ | string | The type of the event. (ActivityFailed, ActivityScheduled, ActivityScheduleFailed, ActivityStarted, ActivitySucceeded, ActivityTimedOut, ChoiceStateEntered, ChoiceStateExited, ExecutionAborted, ExecutionFailed, ExecutionStarted, ExecutionSucceeded, ExecutionTimedOut, FailStateEntered, LambdaFunctionFailed, LambdaFunctionScheduled, LambdaFunctionScheduleFailed, LambdaFunctionStarted, LambdaFunctionStartFailed, LambdaFunctionSucceeded, LambdaFunctionTimedOut, MapIterationAborted, MapIterationFailed, MapIterationStarted, MapIterationSucceeded, MapStateAborted, MapStateEntered, MapStateExited, MapStateFailed, MapStateStarted, MapStateSucceeded, ParallelStateAborted, ParallelStateEntered, ParallelStateExited, ParallelStateFailed, ParallelStateStarted, ParallelStateSucceeded, PassStateEntered, PassStateExited, SucceedStateEntered, SucceedStateExited, TaskFailed, TaskScheduled, TaskStarted, TaskStartFailed, TaskStateAborted, TaskStateEntered, TaskStateExited, TaskSubmitFailed, TaskSubmitted, TaskSucceeded, TaskTimedOut, WaitStateAborted, WaitStateEntered, WaitStateExited, MapRunAborted, MapRunFailed, MapRunStarted, MapRunSucceeded, ExecutionRedriven, MapRunRedriven, EvaluationFailed) |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_execution_history | select | region | 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. Use the reverseOrder parameter to get the latest events first. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an HTTP 400 InvalidToken error. This API action is not supported by EXPRESS state machines. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
region | string | AWS region (default: us-east-1) |
SELECT examples
- get_execution_history
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. Use the reverseOrder parameter to get the latest events first. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an HTTP 400 InvalidToken error. This API action is not supported by EXPRESS state machines.
SELECT
id,
activity_failed_event_details,
activity_schedule_failed_event_details,
activity_scheduled_event_details,
activity_started_event_details,
activity_succeeded_event_details,
activity_timed_out_event_details,
evaluation_failed_event_details,
execution_aborted_event_details,
execution_failed_event_details,
execution_redriven_event_details,
execution_started_event_details,
execution_succeeded_event_details,
execution_timed_out_event_details,
lambda_function_failed_event_details,
lambda_function_schedule_failed_event_details,
lambda_function_scheduled_event_details,
lambda_function_start_failed_event_details,
lambda_function_succeeded_event_details,
lambda_function_timed_out_event_details,
map_iteration_aborted_event_details,
map_iteration_failed_event_details,
map_iteration_started_event_details,
map_iteration_succeeded_event_details,
map_run_failed_event_details,
map_run_redriven_event_details,
map_run_started_event_details,
map_state_started_event_details,
previous_event_id,
state_entered_event_details,
state_exited_event_details,
task_failed_event_details,
task_scheduled_event_details,
task_start_failed_event_details,
task_started_event_details,
task_submit_failed_event_details,
task_submitted_event_details,
task_succeeded_event_details,
task_timed_out_event_details,
timestamp,
type_
FROM aws.stepfunctions.execution_histories
WHERE region = '{{ region }}' -- required
;