SSM / Client / deregister_default_host_management_configuration

deregister_default_host_management_configuration

SSM.Client.deregister_default_host_management_configuration()

Removes the Default Host Management Configuration (DHMC) for an Amazon Web Services account and Amazon Web Services Region. After you deregister DHMC, Amazon EC2 instances are no longer automatically managed as managed nodes by Amazon Web Services Systems Manager.

To use this operation, you must have the following permissions:

  • You need the ssm:GetServiceSetting and ssm:ResetServiceSetting permissions for the /ssm/managed-instance/default-ec2-instance-management-role service setting.

If the registered role is service-managed, you also need the iam:DeleteRole permission so that Amazon Web Services Systems Manager can remove the role it created.

See also: AWS API Documentation

Request Syntax

response = client.deregister_default_host_management_configuration()
Return type:

dict

Returns:

Response Syntax

{}

Response Structure

  • (dict) –

Exceptions