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.

Update or Delete a Maintenance Window (Console)

You can update or delete a maintenance window. You can also update or delete the targets or tasks of a maintenance window. If you edit the details of a maintenance window, you can change the schedule, targets, and tasks. You can also specify names and descriptions for windows, targets, and tasks, which helps you better understand their purpose, and makes it easier to manage your queue of windows.

This section describes how to update or delete a maintenance window, targets, and tasks by using the AWS Systems Manager console. For examples of how to do this by using the AWS CLI, see Tutorial: Update a Maintenance Window (AWS CLI).

Update or Delete a Maintenance Window (Console)

You can update a maintenance window to change its name, description, and schedule, and whether the maintenance window should allow unregistered targets.

To update or delete a maintenance window

  1. Open the AWS Systems Manager console at https://console.aws.amazon.com/systems-manager/.

  2. In the navigation pane, choose Maintenance Windows.

  3. Choose the maintenance window that you want to update or delete, and then do one of the following:

    • Choose Delete. The system prompts you to confirm your actions.

    • Choose Edit. On the Edit maintenance window page, change the values and options that you want, and then choose Edit maintenance window.

      For information about the configuration choices you can make, see Create a Maintenance Window (Console).

Update or Delete Maintenance Window Targets (Console)

You can update or delete the targets of a maintenance window. If you choose to update a maintenance window target you can specify a new target name, description, and owner. You can also choose different targets.

To update or delete the targets of a maintenance window

  1. Open the AWS Systems Manager console at https://console.aws.amazon.com/systems-manager/.

  2. In the navigation pane, choose Maintenance Windows.

  3. Choose the name of the maintenance window that you want to update, and then do one of the following:

    • To update targets, choose Edit.

    • To delete targets, choose Deregister targets, and then choose the Targets tab.

      Choose the target to delete, and then choose Deregister target. In the Deregister maintenance windows target window, leave the Safely deregister target option selected if you want the system to check if the target is referenced by any tasks before deleting it. If the target is referenced by a task, the system returns an error and doesn't delete the target. Clear the Safely deregister target option if you want the system to delete the target even if it is referenced by a task.

      Choose Deregister.

Update or Delete Maintenance Window Tasks (Console)

You can update or delete the tasks of a maintenance window. If you choose to update, you can specify a new task name, description, and owner. For Run Command and Automation tasks, you can choose a different SSM document for the tasks. You can't, however, edit a task to change its type. For example, if you created an Automation task, you can't edit that task and change it to a Run Command task.

To update or delete the tasks of 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. Choose the maintenance window that you want to update.

  4. Choose the Tasks tab.

  5. If you want to delete a task, choose the small x button next to Edit. If you want to edit the task, choose Edit.

  6. Change the values and options that you want, and then choose Edit Task. The system returns you to the maintenance window page.