Deregistering managed nodes in a hybrid environment - AWS Systems Manager

Deregistering managed nodes in a hybrid environment

If you no longer want to manage an on-premises server, edge device, or virtual machine (VM) by using AWS Systems Manager, then you can deregister it. Deregistering a hybrid machine removes it from the list of managed nodes in Systems Manager. AWS Systems Manager Agent (SSM Agent) running on the hybrid machine won't be able to refresh its authorization token because it's no longer registered. SSM Agent hibernates and reduce its ping frequency to Systems Manager in the cloud to once per hour.

You can reregister an on-premises server, edge device, or VM again at any time. Systems Manager stores the command history for a deregistered managed node for 30 days.

The following procedure describes how to deregister a hybrid machine by using the Systems Manager console. For information about how to do this by using the AWS Command Line Interface , see deregister-managed-instance.

To deregister a hybrid machine (console)

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

  2. In the navigation pane, choose Fleet Manager.

    -or-

    If the AWS Systems Manager home page opens first, choose the menu icon ( ) to open the navigation pane, and then choose Fleet Manager in the navigation pane.

  3. Choose the button next to the managed node that you want to deregister.

  4. In the Instance actions menu, choose Deregister this managed instance.

  5. Review the information in the Deregister this managed instance pop-up, and then if you approve, choose Deregister.