/ - Amazon Simple Systems Manager (SSM)

Modifies the target of an existing maintenance window. You can change the following:

Name
Description
Owner
IDs for an ID target
Tags for a Tag target
From any supported tag type to another. The three supported tag types are ID target, Tag target, and resource group. For more information, see Target.

curl --location -g --request POST 'http://ssm.{region}.amazonaws.com/' \ --header 'X-Amz-Target;' \ --header 'Content-Type: application/json' \ --data-raw '{ "WindowId": "string", "WindowTargetId": "string", "Targets": [], "OwnerInformation": "string", "Name": "string", "Description": "string", "Replace": true }'

Request

Header Params

X-Amz-Target

string

required

Body Params application/json

WindowId

string

required

The maintenance window ID with which to modify the target.

>= 20 characters<= 20 characters

Match pattern:

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

WindowTargetId

string

required

The target ID to modify.

>= 36 characters<= 36 characters

Match pattern:

^[0-9a-fA-F]{8}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{12}$

Targets

array [object]

optional

The targets to add or replace.

>= 0 items<= 5 items

OwnerInformation

string <password>

optional

User-provided value that will be included in any Amazon CloudWatch Events events raised while running tasks for these targets in this maintenance window.

>= 1 characters<= 128 characters

Name

string

optional

A name for the update.

>= 3 characters<= 128 characters

Match pattern:

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

Description

string <password>

optional

An optional description for the update.

>= 1 characters<= 128 characters

Replace

boolean

optional

If True, then all fields that are required by the RegisterTargetWithMaintenanceWindow operation are also required for this API request. Optional fields that aren't specified are set to null.

Examples

Responses

🟢200Success

application/json

Body

WindowId

string

optional

The maintenance window ID specified in the update request.

>= 20 characters<= 20 characters

Match pattern:

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

WindowTargetId

string

optional

The target ID specified in the update request.

>= 36 characters<= 36 characters

Match pattern:

^[0-9a-fA-F]{8}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{12}$

Targets

array [object]

optional

The updated targets.

>= 0 items<= 5 items

OwnerInformation

string <password>

optional

The updated owner.

>= 1 characters<= 128 characters

Name

string

optional

The updated name.

>= 3 characters<= 128 characters

Match pattern:

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

Description

string <password>

optional

The updated description.

>= 1 characters<= 128 characters

🟠480DoesNotExistException

🟠481InternalServerError