Skip to main content

available_phone_numbers

Creates, updates, deletes, gets or lists an available_phone_numbers resource.

Overview

Nameavailable_phone_numbers
TypeResource
Idaws.chime_sdk_voice.available_phone_numbers

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
e164_phone_numberstringConfines a search to just the phone numbers in the E.164 format.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
search_available_phone_numbersselectregionarea-code, city, country, state, toll-free-prefix, phone-number-type, max-results, next-tokenSearches the provisioned phone numbers in an organization.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)
area-codestringConfines a search to just the phone numbers associated with the specified area code.
citystringConfines a search to just the phone numbers associated with the specified city.
countrystringConfines a search to just the phone numbers associated with the specified country.
max-resultsintegerThe maximum number of results to return.
next-tokenstringThe token used to return the next page of results.
phone-number-typestringConfines a search to just the phone numbers associated with the specified phone number type, either local or toll-free.
statestringConfines a search to just the phone numbers associated with the specified state.
toll-free-prefixstringConfines a search to just the phone numbers associated with the specified toll-free prefix.

SELECT examples

Searches the provisioned phone numbers in an organization.

SELECT
e164_phone_number
FROM aws.chime_sdk_voice.available_phone_numbers
WHERE region = '{{ region }}' -- required
AND `area-code` = '{{ area-code }}'
AND city = '{{ city }}'
AND country = '{{ country }}'
AND state = '{{ state }}'
AND `toll-free-prefix` = '{{ toll-free-prefix }}'
AND `phone-number-type` = '{{ phone-number-type }}'
AND `max-results` = '{{ max-results }}'
AND `next-token` = '{{ next-token }}'
;