Assign targets to a maintenance window (console) - Amazon Systems Manager
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

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.

Note

If a single maintenance window task is registered with multiple targets, its task invocations occur sequentially and not in parallel. If your task must run on multiple targets at the same time, register a task for each target individually and assign each task the same priority level.

To assign targets to a maintenance window (console)
  1. Open the Amazon Systems Manager console at https://console.amazonaws.cn/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 Amazon 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 the Specify instance tags boxes, specify one or more tag keys and (optional) values that have been or will be added to managed nodes in your account. When the maintenance window runs, it attempts to perform tasks on all of the managed nodes to which these tags have been added.

    If you specify more than one tag key, a node 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 node that you want to include in the maintenance window target.

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

    If a managed node you expect to see isn't listed, see Troubleshooting managed node availability for troubleshooting tips.

    For edge devices and on-premises servers and virtual machines (VMs), see Using Systems Manager in hybrid and multicloud environments

    Choose a resource group

    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:

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

    If the tasks you assign to the maintenance window don't 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 nodes, such as applying a patch baseline or rebooting a node. In the maintenance window 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 nodes in your resource group.

  9. Choose Register target.

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 nodes by node ID, you can register new targets and target nodes by specifying tags applied to managed nodes or choosing resource types from a resource group.