SSM / Client / deregister_managed_instance

deregister_managed_instance#

SSM.Client.deregister_managed_instance(**kwargs)#

Removes the server or virtual machine from the list of registered servers.

If you want to reregister an on-premises server, edge device, or VM, you must use a different Activation Code and Activation ID than used to register the machine previously. The Activation Code and Activation ID must not have already been used on the maximum number of activations specified when they were created. For more information, see Deregistering managed nodes in a hybrid and multicloud environment in the Amazon Web Services Systems Manager User Guide.

Request Syntax

response = client.deregister_managed_instance(
    InstanceId='string'
)

Parameters:

InstanceId (string) –

[REQUIRED]

The ID assigned to the managed node when you registered it using the activation process.

Return type:

dict

Returns:

Response Syntax

{}

Response Structure

(dict) –

Exceptions

SSM.Client.exceptions.InvalidInstanceId
SSM.Client.exceptions.InternalServerError