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