Menu
AWS Systems Manager
API Reference (API Version 2014-11-06)

UpdateMaintenanceWindow

Updates an existing Maintenance Window. Only specified parameters are modified.

Request Syntax

{ "AllowUnassociatedTargets": boolean, "Cutoff": number, "Description": "string", "Duration": number, "Enabled": boolean, "Name": "string", "Replace": boolean, "Schedule": "string", "WindowId": "string" }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

AllowUnassociatedTargets

Whether targets must be registered with the Maintenance Window before tasks can be defined for those targets.

Type: Boolean

Required: No

Cutoff

The number of hours before the end of the Maintenance Window that Systems Manager stops scheduling new tasks for execution.

Type: Integer

Valid Range: Minimum value of 0. Maximum value of 23.

Required: No

Description

An optional description for the update request.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 128.

Required: No

Duration

The duration of the Maintenance Window in hours.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 24.

Required: No

Enabled

Whether the Maintenance Window is enabled.

Type: Boolean

Required: No

Name

The name of the Maintenance Window.

Type: String

Length Constraints: Minimum length of 3. Maximum length of 128.

Pattern: ^[a-zA-Z0-9_\-.]{3,128}$

Required: No

Replace

If True, then all fields that are required by the CreateMaintenanceWindow action are also required for this API request. Optional fields that are not specified are set to null.

Type: Boolean

Required: No

Schedule

The schedule of the Maintenance Window in the form of a cron or rate expression.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 256.

Required: No

WindowId

The ID of the Maintenance Window to update.

Type: String

Length Constraints: Fixed length of 20.

Pattern: ^mw-[0-9a-f]{17}$

Required: Yes

Response Syntax

{ "AllowUnassociatedTargets": boolean, "Cutoff": number, "Description": "string", "Duration": number, "Enabled": boolean, "Name": "string", "Schedule": "string", "WindowId": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

AllowUnassociatedTargets

Whether targets must be registered with the Maintenance Window before tasks can be defined for those targets.

Type: Boolean

Cutoff

The number of hours before the end of the Maintenance Window that Systems Manager stops scheduling new tasks for execution.

Type: Integer

Valid Range: Minimum value of 0. Maximum value of 23.

Description

An optional description of the update.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 128.

Duration

The duration of the Maintenance Window in hours.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 24.

Enabled

Whether the Maintenance Window is enabled.

Type: Boolean

Name

The name of the Maintenance Window.

Type: String

Length Constraints: Minimum length of 3. Maximum length of 128.

Pattern: ^[a-zA-Z0-9_\-.]{3,128}$

Schedule

The schedule of the Maintenance Window in the form of a cron or rate expression.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 256.

WindowId

The ID of the created Maintenance Window.

Type: String

Length Constraints: Fixed length of 20.

Pattern: ^mw-[0-9a-f]{17}$

Errors

For information about the errors that are common to all actions, see Common Errors.

DoesNotExistException

Error returned when the ID specified for a resource (e.g. a Maintenance Window) doesn't exist.

HTTP Status Code: 400

InternalServerError

An error occurred on the server side.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: