Menu
AWS Systems Manager
User Guide

Update or Delete a Maintenance Window

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 Walkthrough: Update a Maintenance Window.

Updating or Deleting a Maintenance Window

You can update a Maintenance Window to changethe name, description, and schedule of the window, and whether the window should allow unregistered targets.

Depending on the service you are using, AWS Systems Manager or Amazon EC2 Systems Manager, use one of the following procedures:

To update or delete a Maintenance Window (AWS Systems Manager)

  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.

To update or delete a Maintenance Window (Amazon EC2 Systems Manager)

  1. Open the Amazon EC2 console, expand Systems Manager Shared Resources in the navigation pane, and then choose Maintenance Windows.

  2. Choose the Maintenance Window that you want to update or delete.

  3. Choose Actions, and then choose either Delete Maintenance Window or Edit maintenance window. If you chose to delete a Maintenance Window the system prompts you to confirm your actions. If you chose to edit a Maintenance Window, the Edit maintenance window page appears.

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

Updating or Deleting the Targets of a Maintenance Window

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.

Depending on the service you are using, AWS Systems Manager or Amazon EC2 Systems Manager, use one of the following procedures:

To update or delete the targets of a Maintenance Window (AWS Systems Manager)

  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.

To update or delete the targets of a Maintenance Window (Amazon EC2 Systems Manager)

  1. Open the Amazon EC2 console, expand Systems Manager Shared Resources in the navigation pane, and then choose Maintenance Windows.

  2. Choose the Maintenance Window that you want to update.

  3. Choose the Targets tab.

  4. If you want to delete a target, choose the small X beside Edit. In the Deregister 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.

    If you want to edit the targets, choose Edit.

    
                                    Updating the targets of a Maintenance Window
  5. Change the values and options that you want, and then choose Edit Target. The system returns you to the Maintenance Window page.

Updating or Deleting the Tasks of a Maintenance Window

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.

Note

The following procedure describes steps that you perform in the Amazon EC2 console. You can also perform these steps in the new AWS Systems Manager console. The steps in the new console will differ from the steps below.

To update or delete the tasks of a Maintenance Window

  1. Open the Amazon EC2 console, expand Systems Manager Shared Resources in the navigation pane, and then choose Maintenance Windows.

  2. Choose the Maintenance Window that you want to update.

  3. Choose the Tasks tab.

  4. If you want to delete a task, choose the small X beside Edit. If you want to edit the task, choose Edit.

    
                                Updating the tasks of a Maintenance Window
  5. Change the values and options that you want, and then choose Edit Task. The system returns you to the Maintenance Window page.