v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141381,185842.7 KB

Retrieves a maintenance window.

post/#X-Amz-Target=AmazonSSM.GetMaintenanceWindow

Headers

X-Amz-Target'AmazonSSM.GetMaintenanceWindow' required

Request body

WindowIdstring required

The ID of the maintenance window for which you want to retrieve information.

Response

Success

WindowIdstring

The ID of the created maintenance window.

Namestring

The name of the maintenance window.

Descriptionstring password

The description of the maintenance window.

StartDatestring

The date and time, in ISO-8601 Extended format, for when the maintenance window is scheduled to become active. The maintenance window won't run before this specified time.

EndDatestring

The date and time, in ISO-8601 Extended format, for when the maintenance window is scheduled to become inactive. The maintenance window won't run after this specified time.

Schedulestring

The schedule of the maintenance window in the form of a cron or rate expression.

ScheduleTimezonestring

The time zone that the scheduled maintenance window executions are based on, in Internet Assigned Numbers Authority (IANA) format. For example: "America/Los_Angeles", "UTC", or "Asia/Seoul". For more information, see the <a href="https://www.iana.org/time-zones">Time Zone Database</a> on the IANA website.

ScheduleOffsetinteger

The number of days to wait to run a maintenance window after the scheduled cron expression date and time.

NextExecutionTimestring

The next time the maintenance window will actually run, taking into account any specified times for the maintenance window to become active or inactive.

Durationinteger

The duration of the maintenance window in hours.

Cutoffinteger

The number of hours before the end of the maintenance window that Amazon Web Services Systems Manager stops scheduling new tasks for execution.

AllowUnassociatedTargetsboolean

Whether targets must be registered with the maintenance window before tasks can be defined for those targets.

Enabledboolean

Indicates whether the maintenance window is enabled.

CreatedDatestring date-time

The date the maintenance window was created.

ModifiedDatestring date-time

The date the maintenance window was last modified.