SSM / Client / deregister_target_from_maintenance_window

deregister_target_from_maintenance_window

SSM.Client.deregister_target_from_maintenance_window(**kwargs)

Removes a target from a maintenance window.

See also: AWS API Documentation

Request Syntax

response = client.deregister_target_from_maintenance_window(
    WindowId='string',
    WindowTargetId='string',
    Safe=True|False
)
Parameters:

  • WindowId (string) –

    [REQUIRED]

    The ID of the maintenance window the target should be removed from.

  • WindowTargetId (string) –

    [REQUIRED]

    The ID of the target definition to remove.

  • Safe (boolean) – The system checks if the target is being referenced by a task. If the target is being referenced, the system returns an error and doesn’t deregister the target from the maintenance window.

Return type:

dict

Returns:

Response Syntax

{
    'WindowId': 'string',
    'WindowTargetId': 'string'
}

Response Structure

  • (dict) –

    • WindowId (string) –

      The ID of the maintenance window the target was removed from.

    • WindowTargetId (string) –

      The ID of the removed target definition.

Exceptions

  • SSM.Client.exceptions.DoesNotExistException

  • SSM.Client.exceptions.InternalServerError

  • SSM.Client.exceptions.TargetInUseException