Assign targets to a maintenance window (console) - AWS Systems Manager

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. Open the AWS Systems Manager console at https://console.aws.amazon.com/systems-manager/.

  2. In the navigation pane, choose Maintenance Windows.

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

  4. Choose Actions, and then choose Register targets.

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

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

  7. (Optional) For Owner information, specify information to include in any EventBridge event raised while running tasks for these targets in this maintenance window.

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

  8. 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.

    If you specify more than one tag key, an instance must be tagged with all the tag keys and values you specify to be included in the target group.

    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 an Amazon EC2 instance you expect to see is not listed, see Troubleshooting Amazon EC2 managed instance availability for troubleshooting tips.

    For on-premises instances and virtual machines (VMs), see Setting up AWS Systems Manager for hybrid environments

    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 Amazon Simple Storage Service (Amazon S3) buckets or Amazon DynamoDB tables being found. However, the maintenance window still runs tasks on the instances in your resource group.

  9. 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.