v1

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

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.

If a parameter is null, then the corresponding field isn't modified.

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

Headers

X-Amz-Target'AmazonSSM.UpdateMaintenanceWindowTarget' required

Request body

WindowIdstring required

The maintenance window ID with which to modify the target.

WindowTargetIdstring required

The target ID to modify.

OwnerInformationstring password

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

Namestring

A name for the update.

Descriptionstring password

An optional description for the update.

Replaceboolean

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

Response

Success

WindowIdstring

The maintenance window ID specified in the update request.

WindowTargetIdstring

The target ID specified in the update request.

OwnerInformationstring password

The updated owner.

Namestring

The updated name.

Descriptionstring password

The updated description.