aws ssm describe-automation-step-executions

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

2 examples 5 options Its page in the AWS CLI reference

Examples

from aws-cli, each command read by CmdID

Example 1: To describe all steps for an automation execution

The following describe-automation-step-executions example displays details about the steps of an Automation execution.

aws ssm describe-automation-step-executions --automation-execution-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111Identify

--automation-execution-idThe Automation execution ID for which you want step execution descriptions.

Its output

{
    "StepExecutions": [
        {
            "StepName": "startInstances",
            "Action": "aws:changeInstanceState",
            "ExecutionStartTime": 1583737234.134,
            "ExecutionEndTime": 1583737234.672,
            "StepStatus": "Success",
            "Inputs": {
                "DesiredState": "\"running\"",
                "InstanceIds": "[\"i-0cb99161f6EXAMPLE\"]"
            },
            "Outputs": {
                "InstanceStates": [
                    "running"
                ]
            },
            "StepExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "OverriddenParameters": {}
        }
    ]
}

Example 2: To describe a specific step for an automation execution

The following describe-automation-step-executions example displays details about a specific step of an Automation execution.

aws ssm describe-automation-step-executions --automation-execution-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 --filters Key=StepExecutionId,Values=a1b2c3d4-5678-90ab-cdef-EXAMPLE22222

Identify

--automation-execution-idThe Automation execution ID for which you want step execution descriptions.

--filtersOne or more filters to limit the number of step executions returned by the request.

Its output

{
    "StepExecutions": [
        {
            "StepName": "startInstances",
            "Action": "aws:changeInstanceState",
            "ExecutionStartTime": 1583737234.134,
            "ExecutionEndTime": 1583737234.672,
            "StepStatus": "Success",
            "Inputs": {
                "DesiredState": "\"running\"",
                "InstanceIds": "[\"i-0cb99161f6EXAMPLE\"]"
            },
            "Outputs": {
                "InstanceStates": [
                    "running"
                ]
            },
            "StepExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "OverriddenParameters": {}
        }
    ]
}

For more information, see Running an Automation Workflow Step by Step (Command Line) in the AWS Systems Manager User Guide.

Options

5 in the AWS CLI reference

--automation-execution-idThe Automation execution ID for which you want step execution descriptions.

--filtersOne or more filters to limit the number of step executions returned by the request.

--max-resultsThe maximum number of items to return for this call.

--next-tokenThe token for the next set of items to return.

--reverse-orderIndicates whether to list step executions in reverse order by start time.