AWS Systems Manager
User Guide

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

Assign Targets to a Maintenance Window (Console)

In this procedure, you register a target with a maintenance window. In other words, you specify which resources the maintenance window performs actions on.

To assign targets to a maintenance window (console)

  1. In the list of maintenance windows, choose the maintenance window to add targets to.

  2. Choose Actions, and then choose Register targets.

  3. (Optional) For Target name, enter a name for the targets.

  4. (Optional) For Description, enter a description.

  5. (Optional) For Owner information, specify information to include in any CloudWatch Events raised while running tasks for these targets in this maintenance window.

    For information about using CloudWatch Events to monitor Systems Manager events, see Monitoring Systems Manager Events with Amazon CloudWatch Events.

  6. In the Targets area, choose one of the options described in the following table.

    Option Description

    Specify instance tags

    For Instance tags, specify one or more tag keys and (optional) values that have been or will be added to managed instances in your account. When the maintenance window runs, it attempts to perform tasks on all of the managed instances to which these tags have been added.

    Choose instances manually

    From the list, select the box for each instance that you want to include in the maintenance window target.

    The list includes all instances in your account that are configured for use with Systems Manager.

    If you don’t see an instance you want to include in the target, verify that the required setup steps have been completed:

    Choose resource groups

    For Resource group, choose the name of an existing resource group in your account from the list.

    For information about creating and working with resource groups, see the following topics:

    For Resource types, select up to five available resource types, or choose All resource types.

    If the tasks you assign to the maintenance window do not act on one of the resource types you added to the target, the system might report an error. Tasks for which a supported resource type is found continue to run despite these errors.

    For example, suppose you add the following resource types to this target:

    • AWS::S3::Bucket

    • AWS::DynamoDB::Table

    • AWS::EC2::Instance

    But later, when you add tasks to the maintenance window, you include only tasks that perform actions on instances, such as applying a patch baseline or rebooting an instance. In the maintenancewindow log, an error might be reported for no S3 buckets or DynamoDB tables being found. However, the maintenance window still runs tasks on the instances in your resource group.

  7. Choose Register targets.

If you want to assign more targets to this maintenance window, choose the Targets tab, and then choose Register target. With this option, you can choose a different means of targeting. For example, if you previously targeted instances by instance ID, you can register new targets and target instances by specifying tags applied to managed instances or choosing resource types from a resource group.