ClaimedPhoneNumberSummary - Amazon Connect

ClaimedPhoneNumberSummary

Information about a phone number that has been claimed to your Amazon Connect instance or traffic distribution group.

Contents

PhoneNumber

The phone number. Phone numbers are formatted [+] [country code] [subscriber number including area code].

Type: String

Pattern: \\+[1-9]\\d{1,14}$

Required: No

PhoneNumberArn

The Amazon Resource Name (ARN) of the phone number.

Type: String

Required: No

PhoneNumberCountryCode

The ISO country code.

Type: String

Valid Values: AF | AL | DZ | AS | AD | AO | AI | AQ | AG | AR | AM | AW | AU | AT | AZ | BS | BH | BD | BB | BY | BE | BZ | BJ | BM | BT | BO | BA | BW | BR | IO | VG | BN | BG | BF | BI | KH | CM | CA | CV | KY | CF | TD | CL | CN | CX | CC | CO | KM | CK | CR | HR | CU | CW | CY | CZ | CD | DK | DJ | DM | DO | TL | EC | EG | SV | GQ | ER | EE | ET | FK | FO | FJ | FI | FR | PF | GA | GM | GE | DE | GH | GI | GR | GL | GD | GU | GT | GG | GN | GW | GY | HT | HN | HK | HU | IS | IN | ID | IR | IQ | IE | IM | IL | IT | CI | JM | JP | JE | JO | KZ | KE | KI | KW | KG | LA | LV | LB | LS | LR | LY | LI | LT | LU | MO | MK | MG | MW | MY | MV | ML | MT | MH | MR | MU | YT | MX | FM | MD | MC | MN | ME | MS | MA | MZ | MM | NA | NR | NP | NL | AN | NC | NZ | NI | NE | NG | NU | KP | MP | NO | OM | PK | PW | PA | PG | PY | PE | PH | PN | PL | PT | PR | QA | CG | RE | RO | RU | RW | BL | SH | KN | LC | MF | PM | VC | WS | SM | ST | SA | SN | RS | SC | SL | SG | SX | SK | SI | SB | SO | ZA | KR | ES | LK | SD | SR | SJ | SZ | SE | CH | SY | TW | TJ | TZ | TH | TG | TK | TO | TT | TN | TR | TM | TC | TV | VI | UG | UA | AE | GB | US | UY | UZ | VU | VA | VE | VN | WF | EH | YE | ZM | ZW

Required: No

PhoneNumberDescription

The description of the phone number.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 500.

Pattern: ^[\W\S_]*

Required: No

PhoneNumberId

A unique identifier for the phone number.

Type: String

Required: No

PhoneNumberStatus

The status of the phone number.

  • CLAIMED means the previous ClaimedPhoneNumber or UpdatePhoneNumber operation succeeded.

  • IN_PROGRESS means a ClaimedPhoneNumber or UpdatePhoneNumber operation is still in progress and has not yet completed. You can call DescribePhoneNumber at a later time to verify if the previous operation has completed.

  • FAILED indicates that the previous ClaimedPhoneNumber or UpdatePhoneNumber operation has failed. It will include a message indicating the failure reason. A common reason for a failure may be that the TargetArn value you are claiming or updating a phone number to has reached its limit of total claimed numbers. If you received a FAILED status from a ClaimPhoneNumber API call, you have one day to retry claiming the phone number before the number is released back to the inventory for other customers to claim.

Note

You will not be billed for the phone number during the 1-day period if number claiming fails.

Type: PhoneNumberStatus object

Required: No

PhoneNumberType

The type of phone number.

Type: String

Valid Values: TOLL_FREE | DID

Required: No

Tags

The tags used to organize, track, or control access for this resource. For example, { "tags": {"key1":"value1", "key2":"value2"} }.

Type: String to string map

Map Entries: Maximum number of 50 items.

Key Length Constraints: Minimum length of 1. Maximum length of 128.

Key Pattern: ^(?!aws:)[a-zA-Z+-=._:/]+$

Value Length Constraints: Maximum length of 256.

Required: No

TargetArn

The Amazon Resource Name (ARN) for Amazon Connect instances or traffic distribution groups that phone numbers are claimed to.

Type: String

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: