AWS CloudFormation
User Guide (Version )

AWS::SSM::MaintenanceWindowTarget

The AWS::SSM::MaintenanceWindowTarget resource registers a target with a Maintenance Window for AWS Systems Manager. For more information, see RegisterTargetWithMaintenanceWindow in the AWS Systems Manager API Reference.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{ "Type" : "AWS::SSM::MaintenanceWindowTarget", "Properties" : { "Description" : String, "Name" : String, "OwnerInformation" : String, "ResourceType" : String, "Targets" : [ Targets, ... ], "WindowId" : String } }

YAML

Type: AWS::SSM::MaintenanceWindowTarget Properties :  Description : String  Name : String  OwnerInformation : String  ResourceType : String  Targets : - Targets  WindowId : String

Properties

Description

A description for the target.

Required: No

Type: String

Minimum: 1

Maximum: 128

Update requires: No interruption

Name

The target name.

Required: No

Type: String

Minimum: 3

Maximum: 128

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

Update requires: No interruption

OwnerInformation

A user-provided value that will be included in any CloudWatch events that are raised while running tasks for these targets in this Maintenance Window.

Required: No

Type: String

Minimum: 1

Maximum: 128

Update requires: No interruption

ResourceType

The type of target that is being registered with the Maintenance Window.

Required: Yes

Type: String

Allowed Values: INSTANCE

Update requires: No interruption

Targets

The targets, either instances or tags.

Specify instances using the following format:

Key=instanceids,Values=<instanceid1>,<instanceid2>

Tags are specified using the following format:

Key=<tag name>,Values=<tag value>.

Required: Yes

Type: List of Targets

Maximum: 5

Update requires: No interruption

WindowId

The ID of the Maintenance Window to register the target with.

Required: Yes

Type: String

Minimum: 20

Maximum: 20

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

Update requires: Replacement

Return Values

Ref

When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns the Maintenance Window target ID, such as 12a345b6-bbb7-4bb6-90b0-8c9577a2d2b9.

For more information about using the Ref function, see Ref.

See Also