SSMContacts / Client / get_contact_channel

get_contact_channel#

SSMContacts.Client.get_contact_channel(**kwargs)#

List details about a specific contact channel.

See also: AWS API Documentation

Request Syntax

response = client.get_contact_channel(
    ContactChannelId='string'
)
Parameters:

ContactChannelId (string) –

[REQUIRED]

The Amazon Resource Name (ARN) of the contact channel you want information about.

Return type:

dict

Returns:

Response Syntax

{
    'ContactArn': 'string',
    'ContactChannelArn': 'string',
    'Name': 'string',
    'Type': 'SMS'|'VOICE'|'EMAIL',
    'DeliveryAddress': {
        'SimpleAddress': 'string'
    },
    'ActivationStatus': 'ACTIVATED'|'NOT_ACTIVATED'
}

Response Structure

  • (dict) –

    • ContactArn (string) –

      The ARN of the contact that the channel belongs to.

    • ContactChannelArn (string) –

      The ARN of the contact channel.

    • Name (string) –

      The name of the contact channel

    • Type (string) –

      The type of contact channel. The type is SMS, VOICE, or EMAIL.

    • DeliveryAddress (dict) –

      The details that Incident Manager uses when trying to engage the contact channel.

      • SimpleAddress (string) –

        The format is dependent on the type of the contact channel. The following are the expected formats:

        • SMS - ‘+’ followed by the country code and phone number

        • VOICE - ‘+’ followed by the country code and phone number

        • EMAIL - any standard email format

    • ActivationStatus (string) –

      A Boolean value indicating if the contact channel has been activated or not.

Exceptions

  • SSMContacts.Client.exceptions.AccessDeniedException

  • SSMContacts.Client.exceptions.DataEncryptionException

  • SSMContacts.Client.exceptions.InternalServerException

  • SSMContacts.Client.exceptions.ResourceNotFoundException

  • SSMContacts.Client.exceptions.ThrottlingException

  • SSMContacts.Client.exceptions.ValidationException

Examples

The following get-contact-channel example lists the details of a contact channel.

response = client.get_contact_channel(
    ContactChannelId='arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d',
)

print(response)

Expected Output:

{
    'ActivationStatus': 'ACTIVATED',
    'ContactArn': 'arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam',
    'ContactChannelArn': 'arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d',
    'DeliveryAddress': {
        'SimpleAddress': '+15005550199',
    },
    'Name': 'akuas sms',
    'Type': 'SMS',
    'ResponseMetadata': {
        '...': '...',
    },
}