Skip to content
AWS for Query.Farm

aws.ssm.get_maintenance_window_execution_task

Example SQL Queries

SELECT * FROM
aws.ssm.get_maintenance_window_execution_task
WHERE
"window_execution_id" = 'VALUE'
AND "task_id" = 'VALUE';

Description

Retrieves the details about a specific task run as part of a maintenance window execution.

Table Definition

Column NameColumn Data Type
task_id Required Input Column

The ID of the specific task execution in the maintenance window task that should be retrieved.

VARCHAR
window_execution_id Required Input Column

The ID of the maintenance window execution that includes the task.

VARCHAR
_aws_profile Input Column

The AWS profile defines the AWS identity used. It can be defined via credentials or by assuming a IAM role.

STRUCT(
    "type" VARCHAR,
    "name" VARCHAR,
    "account_id" VARCHAR,
    "via_profile_name" VARCHAR,
    "assumed_role_arn" VARCHAR,
    "organization" STRUCT(
        "account_name" VARCHAR,
        "id" VARCHAR,
        "tags" STRUCT(
            "key" VARCHAR,
            "value" VARCHAR
        )[],
        "master_account" STRUCT(
            "id" VARCHAR,
            "email" VARCHAR
        ),
        "parents" STRUCT(
            "type" VARCHAR,
            "id" VARCHAR,
            "name" VARCHAR,
            "tags" STRUCT(
                "key" VARCHAR,
                "value" VARCHAR
            )[]
        )[]
    )
)
Show child fields
_aws_profile.account_id

The AWS account id

_aws_profile.assumed_role_arn

The ARN of the assumed role

_aws_profile.name

The unique name of the profile.

_aws_profile.organization

Information about this profile's membership in the AWS organization.

Show child fields
_aws_profile.organization.account_name

The name of account speciifed by the organization

_aws_profile.organization.id

The organization id

_aws_profile.organization.master_account
Show child fields
_aws_profile.organization.master_account.email

The organization master account email address

_aws_profile.organization.master_account.id

The organization master account id

_aws_profile.organization.parents[]
Show child fields
_aws_profile.organization.parents[].id

The id of the parent

_aws_profile.organization.parents[].name

The name of the parent

_aws_profile.organization.parents[].tags[]
Show child fields
_aws_profile.organization.parents[].tags[].key
_aws_profile.organization.parents[].tags[].value
_aws_profile.organization.parents[].type

The type of parent can be an organization unit or a root

_aws_profile.organization.tags[]
Show child fields
_aws_profile.organization.tags[].key
_aws_profile.organization.tags[].value
_aws_profile.type

The type of profile, either 'credentials' or 'assumed_role'

_aws_profile.via_profile_name

This IAM role for this profile is assumed by first utilizing another profile with this name to obtain credentials.

_aws_region Input Column

The AWS region to use.

VARCHAR
alarm_configuration

The details for the CloudWatch alarm you applied to your maintenance window task.

STRUCT(
    "ignore_poll_alarm_failure" BOOLEAN,
    "alarms" STRUCT(
        "name" VARCHAR
    )[]
)
Show child fields
alarm_configuration.alarms[]
Show child fields
alarm_configuration.alarms[].name

The name of your CloudWatch alarm.

alarm_configuration.ignore_poll_alarm_failure

When this value is true, your automation or command continues to run in cases where we can’t retrieve alarm status information from CloudWatch. In cases where we successfully retrieve an alarm status of OK or INSUFFICIENT_DATA, the automation or command continues to run, regardless of this value. Default is false.

end_time

The time the task execution completed.

TIMESTAMP_S
max_concurrency

The defined maximum number of task executions that could be run in parallel.

VARCHAR
max_errors

The defined maximum number of task execution errors allowed before scheduling of the task execution would have been stopped.

VARCHAR
priority

The priority of the task.

BIGINT
service_role

The role that was assumed when running the task.

VARCHAR
start_time

The time the task execution started.

TIMESTAMP_S
status

The status of the task.

VARCHAR
status_details

The details explaining the status. Not available for all status values.

VARCHAR
task_arn

The Amazon Resource Name (ARN) of the task that ran.

VARCHAR
task_execution_id

The ID of the specific task execution in the maintenance window task that was retrieved.

VARCHAR
task_parameters

The parameters passed to the task when it was run.

TaskParameters has been deprecated. To specify parameters to pass to a task when it runs, instead use the Parameters option in the TaskInvocationParameters structure. For information about how Systems Manager handles these options for the supported maintenance window task types, see MaintenanceWindowTaskInvocationParameters.

The map has the following format:

  • Key: string, between 1 and 255 characters

  • Value: an array of strings, each between 1 and 255 characters

MAP(VARCHAR, STRUCT(
        "values" VARCHAR[]
    ))[]
Show child fields
task_parameters[]
triggered_alarms

The CloudWatch alarms that were invoked by the maintenance window task.

STRUCT(
    "name" VARCHAR,
    "state" VARCHAR
)[]
Show child fields
triggered_alarms[]
Show child fields
triggered_alarms[].name

The name of your CloudWatch alarm.

triggered_alarms[].state

The state of your CloudWatch alarm.

type

The type of task that was run.

VARCHAR