PinpointSMSVoiceV2 / Client / delete_registration

delete_registration#

PinpointSMSVoiceV2.Client.delete_registration(**kwargs)#

Permanently delete an existing registration from your account.

Request Syntax

response = client.delete_registration(
    RegistrationId='string'
)

Parameters:

RegistrationId (string) –

[REQUIRED]

The unique identifier for the registration.

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,
    'ApprovedVersionNumber': 123,
    'LatestDeniedVersionNumber': 123,
    'AdditionalAttributes': {
        'string': '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. 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.
- ApprovedVersionNumber (integer) –
  
  The version number of the registration that was approved.
- LatestDeniedVersionNumber (integer) –
  
  The latest version number of the registration that was denied.
- AdditionalAttributes (dict) –
  
  Metadata about a given registration which is specific to that registration type.
  - (string) –
    - (string) –
- CreatedTimestamp (datetime) –
  
  The time when the registration was created, in UNIX epoch time format.

Exceptions

PinpointSMSVoiceV2.Client.exceptions.ThrottlingException
PinpointSMSVoiceV2.Client.exceptions.AccessDeniedException
PinpointSMSVoiceV2.Client.exceptions.ResourceNotFoundException
PinpointSMSVoiceV2.Client.exceptions.ValidationException
PinpointSMSVoiceV2.Client.exceptions.ConflictException
PinpointSMSVoiceV2.Client.exceptions.InternalServerException