PinpointSMSVoiceV2 / Client / request_sender_id

request_sender_id

PinpointSMSVoiceV2.Client.request_sender_id(**kwargs)

Request a new sender ID that doesn’t require registration.

See also: AWS API Documentation

Request Syntax

response = client.request_sender_id(
    SenderId='string',
    IsoCountryCode='string',
    MessageTypes=[
        'TRANSACTIONAL'|'PROMOTIONAL',
    ],
    DeletionProtectionEnabled=True|False,
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ],
    ClientToken='string'
)

Parameters:

• SenderId (string) –

  [REQUIRED]

  The sender ID string to request.

• IsoCountryCode (string) –

  [REQUIRED]

  The two-character code, in ISO 3166-1 alpha-2 format, for the country or region.

• MessageTypes (list) –

  The type of message. Valid values are TRANSACTIONAL for messages that are critical or time-sensitive and PROMOTIONAL for messages that aren’t critical or time-sensitive.

  • (string) –

• DeletionProtectionEnabled (boolean) – By default this is set to false. When set to true the sender ID can’t be deleted.

• Tags (list) –

  An array of tags (key and value pairs) to associate with the sender ID.

  • (dict) –

    The list of tags to be added to the specified topic.

    • Key (string) – [REQUIRED]

      The key identifier, or name, of the tag.

    • Value (string) – [REQUIRED]

      The string value associated with the key of the tag.

• ClientToken (string) –

  Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If you don’t specify a client token, a randomly generated token is used for the request to ensure idempotency.

  This field is autopopulated if not provided.

Return type:

dict

Returns:

Response Syntax

{
    'SenderIdArn': 'string',
    'SenderId': 'string',
    'IsoCountryCode': 'string',
    'MessageTypes': [
        'TRANSACTIONAL'|'PROMOTIONAL',
    ],
    'MonthlyLeasingPrice': 'string',
    'DeletionProtectionEnabled': True|False,
    'Registered': True|False,
    'Tags': [
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
}

Response Structure

• (dict) –

  • SenderIdArn (string) –

    The Amazon Resource Name (ARN) associated with the SenderId.

  • SenderId (string) –

    The sender ID that was requested.

  • IsoCountryCode (string) –

    The two-character code, in ISO 3166-1 alpha-2 format, for the country or region.

  • MessageTypes (list) –

    The type of message. Valid values are TRANSACTIONAL for messages that are critical or time-sensitive and PROMOTIONAL for messages that aren’t critical or time-sensitive.

    • (string) –

  • MonthlyLeasingPrice (string) –

    The monthly price, in US dollars, to lease the sender ID.

  • DeletionProtectionEnabled (boolean) –

    By default this is set to false. When set to true the sender ID can’t be deleted.

  • Registered (boolean) –

    True if the sender ID is registered.

  • Tags (list) –

    An array of tags (key and value pairs) to associate with the sender ID.

    • (dict) –

      The list of tags to be added to the specified topic.

      • Key (string) –

        The key identifier, or name, of the tag.

      • Value (string) –

        The string value associated with the key of the tag.

Exceptions

• PinpointSMSVoiceV2.Client.exceptions.ServiceQuotaExceededException

• PinpointSMSVoiceV2.Client.exceptions.ThrottlingException

• PinpointSMSVoiceV2.Client.exceptions.AccessDeniedException

• PinpointSMSVoiceV2.Client.exceptions.ValidationException

• PinpointSMSVoiceV2.Client.exceptions.ConflictException

• PinpointSMSVoiceV2.Client.exceptions.InternalServerException