PinpointSMSVoiceV2 / Client / create_registration

create_registration#

PinpointSMSVoiceV2.Client.create_registration(**kwargs)#

Creates a new registration based on the RegistrationType field.

See also: AWS API Documentation

Request Syntax

response = client.create_registration(
    RegistrationType='string',
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ],
    ClientToken='string'
)
Parameters:

  • RegistrationType (string) –

    [REQUIRED]

    The type of registration form to create. The list of RegistrationTypes can be found using the DescribeRegistrationTypeDefinitions action.

  • Tags (list) –

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

    • (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

{
    'RegistrationArn': 'string',
    'RegistrationId': 'string',
    'RegistrationType': 'string',
    'RegistrationStatus': 'CREATED'|'SUBMITTED'|'REVIEWING'|'REQUIRES_AUTHENTICATION'|'PROVISIONING'|'COMPLETE'|'REQUIRES_UPDATES'|'CLOSED'|'DELETED',
    'CurrentVersionNumber': 123,
    'AdditionalAttributes': {
        'string': 'string'
    },
    'Tags': [
        {
            'Key': 'string',
            'Value': 'string'
        },
    ],
    'CreatedTimestamp': datetime(2015, 1, 1)
}

Response Structure

  • (dict) –

    • RegistrationArn (string) –

      The Amazon Resource Name (ARN) for the registration.

    • RegistrationId (string) –

      The unique identifier for the registration.

    • RegistrationType (string) –

      The type of registration form to create. The list of RegistrationTypes can be found using the DescribeRegistrationTypeDefinitions action.

    • RegistrationStatus (string) –

      The status of the registration.

      • CREATED: Your registration is created but not submitted.

      • SUBMITTED: Your registration has been submitted and is awaiting review.

      • REVIEWING: Your registration has been accepted and is being reviewed.

      • PROVISIONING: Your registration has been approved and your origination identity is being created.

      • COMPLETE: Your registration has been approved and and your origination identity has been created.

      • REQUIRES_UPDATES: You must fix your registration and resubmit it.

      • CLOSED: The phone number or sender ID has been deleted and you must also delete the registration for the number.

      • DELETED: The registration has been deleted.

    • CurrentVersionNumber (integer) –

      The current version number of the registration.

    • AdditionalAttributes (dict) –

      Metadata about a given registration which is specific to that registration type.

      • (string) –

        • (string) –

    • Tags (list) –

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

      • (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.

    • CreatedTimestamp (datetime) –

      The time when the registration was created, in UNIX epoch time format.

Exceptions