Chime / Client / create_phone_number_order

create_phone_number_order#

Chime.Client.create_phone_number_order(**kwargs)#

Creates an order for phone numbers to be provisioned. For toll-free numbers, you cannot use the Amazon Chime Business Calling product type. For numbers outside the U.S., you must use the Amazon Chime SIP Media Application Dial-In product type.

Request Syntax

response = client.create_phone_number_order(
    ProductType='BusinessCalling'|'VoiceConnector'|'SipMediaApplicationDialIn',
    E164PhoneNumbers=[
        'string',
    ]
)

Parameters:

ProductType (string) –
[REQUIRED]

The phone number product type.
E164PhoneNumbers (list) –
[REQUIRED]

List of phone numbers, in E.164 format.
- (string) –

Return type:

dict

Returns:

Response Syntax

{
    'PhoneNumberOrder': {
        'PhoneNumberOrderId': 'string',
        'ProductType': 'BusinessCalling'|'VoiceConnector'|'SipMediaApplicationDialIn',
        'Status': 'Processing'|'Successful'|'Failed'|'Partial',
        'OrderedPhoneNumbers': [
            {
                'E164PhoneNumber': 'string',
                'Status': 'Processing'|'Acquired'|'Failed'
            },
        ],
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1)
    }
}

Response Structure

(dict) –
- PhoneNumberOrder (dict) –
  
  The phone number order details.
  - PhoneNumberOrderId (string) –
    
    The phone number order ID.
  - ProductType (string) –
    
    The phone number order product type.
  - Status (string) –
    
    The status of the phone number order.
  - OrderedPhoneNumbers (list) –
    
    The ordered phone number details, such as the phone number in E.164 format and the phone number status.
    - (dict) –
      
      A phone number for which an order has been placed.
      - E164PhoneNumber (string) –
        
        The phone number, in E.164 format.
      - Status (string) –
        
        The phone number status.
  - CreatedTimestamp (datetime) –
    
    The phone number order creation time stamp, in ISO 8601 format.
  - UpdatedTimestamp (datetime) –
    
    The updated phone number order time stamp, in ISO 8601 format.

Exceptions

Chime.Client.exceptions.BadRequestException
Chime.Client.exceptions.ForbiddenException
Chime.Client.exceptions.AccessDeniedException
Chime.Client.exceptions.UnauthorizedClientException
Chime.Client.exceptions.ThrottledClientException
Chime.Client.exceptions.ResourceLimitExceededException
Chime.Client.exceptions.ServiceUnavailableException
Chime.Client.exceptions.ServiceFailureException