Skip to main content

automation_step_executions

Creates, updates, deletes, gets or lists an automation_step_executions resource.

Overview

Nameautomation_step_executions
TypeResource
Idaws.ssm.automation_step_executions

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
actionstringThe action this step performs. The action determines the behavior of the step. (pattern: <code>^aws:[a-zA-Z]{3,25}$</code>)
execution_end_timestring (date-time)If a step has finished execution, this contains the time the execution ended. If the step hasn't yet concluded, this field isn't populated.
execution_start_timestring (date-time)If a step has begun execution, this contains the time the step started. If the step is in Pending status, this field isn't populated.
failure_detailsobjectInformation about the Automation failure.
failure_messagestringIf a step failed, this message explains why the execution failed.
inputsobjectFully-resolved values passed into the step before execution.
is_criticalbooleanThe flag which can be used to help decide whether the failure of current step leads to the Automation failure.
is_endbooleanThe flag which can be used to end automation no matter whether the step succeeds or fails.
max_attemptsintegerThe maximum number of tries to run the action of the step. The default value is 1.
next_stepstringThe next step after the step succeeds.
on_failurestringThe action to take if the step fails. The default value is Abort.
outputsobjectReturned values from the execution of the step.
overridden_parametersobjectA user-specified list of parameters to override when running a step.
parent_step_detailsobjectInformation about the parent step.
responsestringA message associated with the response code for an execution.
response_codestringThe response code returned by the execution of the step.
step_execution_idstringThe unique ID of a step execution.
step_namestringThe name of this execution step.
step_statusstringThe execution status for this step. (Pending, InProgress, Waiting, Success, TimedOut, Cancelling, Cancelled, Failed, PendingApproval, Approved, Rejected, Scheduled, RunbookInProgress, PendingChangeCalendarOverride, ChangeCalendarOverrideApproved, ChangeCalendarOverrideRejected, CompletedWithSuccess, CompletedWithFailure, Exited)
target_locationobjectThe combination of Amazon Web Services Regions and Amazon Web Services accounts targeted by the current Automation execution.
targetsarrayThe targets for the step execution.
timeout_secondsinteger (int64)The timeout seconds of the step.
triggered_alarmsarrayThe CloudWatch alarms that were invoked by the automation.
valid_next_stepsarrayStrategies used when step fails, we support Continue and Abort. Abort will fail the automation when the step fails. Continue will ignore the failure of current step and allow automation to run the next step. With conditional branching, we add step:stepName to support the automation to go to another specific step.
warning_messagestringA message that describes a non-critical issue that occurred during the step execution. Present only if the step status includes a warning.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
describe_automation_step_executionsselectregionInformation about all active and terminated step executions in an Automation workflow.

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.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)

SELECT examples

Information about all active and terminated step executions in an Automation workflow.

SELECT
action,
execution_end_time,
execution_start_time,
failure_details,
failure_message,
inputs,
is_critical,
is_end,
max_attempts,
next_step,
on_failure,
outputs,
overridden_parameters,
parent_step_details,
response,
response_code,
step_execution_id,
step_name,
step_status,
target_location,
targets,
timeout_seconds,
triggered_alarms,
valid_next_steps,
warning_message
FROM aws.ssm.automation_step_executions
WHERE region = '{{ region }}' -- required
;