aws ssm describe-maintenance-window-executions

Lists the executions of a maintenance window. AWS CLI reference

3 examples 4 options Its page in the AWS CLI reference

Examples

from aws-cli, each command read by CmdID

Example 1: To list all executions for a maintenance window

The following describe-maintenance-window-executions example lists all of the executions for the specified maintenance window.

aws ssm describe-maintenance-window-executions --window-id "mw-ab12cd34efEXAMPLE"Identify

--window-idThe ID of the maintenance window whose executions should be retrieved.

Its output

{
    "WindowExecutions": [
        {
            "WindowId": "mw-ab12cd34efEXAMPLE",
            "WindowExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "Status": "IN_PROGRESS",
            "StartTime": "2021-08-04T11:00:00.000000-07:00"

        },
        {
            "WindowId": "mw-ab12cd34efEXAMPLE",
            "WindowExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "Status": "SUCCESS",
            "StartTime": "2021-08-03T11:00:00.000000-07:00",
            "EndTime": "2021-08-03T11:37:21.450000-07:00"
        },
        {
            "WindowId": "mw-ab12cd34efEXAMPLE",
            "WindowExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
            "Status": "FAILED",
            "StatusDetails": "One or more tasks in the orchestration failed.",
            "StartTime": "2021-08-02T11:00:00.000000-07:00",
            "EndTime": "2021-08-02T11:22:36.190000-07:00"
        }
    ]
}

Example 2: To list all executions for a maintenance window before a specified date

The following describe-maintenance-window-executions example lists all of the executions for the specified maintenance window before the specified date.

aws ssm describe-maintenance-window-executions --window-id "mw-ab12cd34efEXAMPLE" --filters "Key=ExecutedBefore,Values=2021-08-03T00:00:00Z"

Identify

--window-idThe ID of the maintenance window whose executions should be retrieved.

--filtersEach entry in the array is a structure containing: Key.

Its output

{
    "WindowExecutions": [
        {
            "WindowId": "mw-ab12cd34efEXAMPLE",
            "WindowExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
            "Status": "FAILED",
            "StatusDetails": "One or more tasks in the orchestration failed.",
            "StartTime": "2021-08-02T11:00:00.000000-07:00",
            "EndTime": "2021-08-02T11:22:36.190000-07:00"
        }
    ]
}

Example 3: To list all executions for a maintenance window after a specified date

The following describe-maintenance-window-executions example lists all of the executions for the specified maintenance window after the specified date.

aws ssm describe-maintenance-window-executions --window-id "mw-ab12cd34efEXAMPLE" --filters "Key=ExecutedAfter,Values=2021-08-04T00:00:00Z"

Identify

--window-idThe ID of the maintenance window whose executions should be retrieved.

--filtersEach entry in the array is a structure containing: Key.

Its output

{
    "WindowExecutions": [
        {
            "WindowId": "mw-ab12cd34efEXAMPLE",
            "WindowExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "Status": "IN_PROGRESS",
            "StartTime": "2021-08-04T11:00:00.000000-07:00"
        }
    ]
}

For more information, see View information about tasks and task executions (AWS CLI) in the AWS Systems Manager User Guide.

Options

4 in the AWS CLI reference

--filtersEach entry in the array is a structure containing: Key.

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

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

--window-idThe ID of the maintenance window whose executions should be retrieved.