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.

See also: AWS API Documentation

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