SSMContacts / Client / delete_contact

delete_contact

SSMContacts.Client.delete_contact(**kwargs)

To remove a contact from Incident Manager, you can delete the contact. However, deleting a contact does not remove it from escalation plans and related response plans. Deleting an escalation plan also does not remove it from all related response plans. To modify an escalation plan, we recommend using the UpdateContact action to specify a different existing contact.

See also: AWS API Documentation

Request Syntax

response = client.delete_contact(
    ContactId='string'
)

Parameters:

ContactId (string) –

[REQUIRED]

The Amazon Resource Name (ARN) of the contact that you’re deleting.

Return type:

dict

Returns:

Response Syntax

{}

Response Structure

• (dict) –

Exceptions

• SSMContacts.Client.exceptions.AccessDeniedException

• SSMContacts.Client.exceptions.InternalServerException

• SSMContacts.Client.exceptions.ResourceNotFoundException

• SSMContacts.Client.exceptions.ThrottlingException

• SSMContacts.Client.exceptions.ConflictException

• SSMContacts.Client.exceptions.ValidationException

Examples

The following delete-contact example deletes a contact. The contact will no longer be reachable from any escalation plan that refers to them.

response = client.delete_contact(
    ContactId='arn:aws:ssm-contacts:us-east-1:111122223333:contact/alejr',
)

print(response)

Expected Output:

{
    'ResponseMetadata': {
        '...': '...',
    },
}