本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 Amazon Connect 向流分配组申请电话号码
<a name="claim-phone-numbers-traffic-distribution-groups"></a>

**注意**  
**新用户？** 查看 [Amazon Connect 全球弹性研讨会](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US)。本在线课程将指导您完成通过 AWS CLI 使用新 APIs 功能注册和测试电话号码和代理故障转移的过程。  
全球弹性仅适用于在以下 AWS 区域创建的 Amazon Connect 实例：美国东部（弗吉尼亚北部）、美国西部（俄勒冈）、亚太地区（大阪）、亚太地区（东京）、欧洲（法兰克福）和欧洲（伦敦）。  
如果您的数据源是美国西部（俄勒冈州），则只能在美国东部（弗吉尼亚州北部）区域创建副本，反之亦然。
如果源是欧洲地区（伦敦），则只能在欧洲地区（法兰克福）区域中创建副本，反之亦然。
如果源是亚太地区（东京），则只能在亚太地区（大阪）区域中创建副本。
要获得对此功能的访问权限，请联系您的 Amazon Connect 解决方案架构师或技术客户经理。

 成功创建流量分发组后，您可以使用搜索[SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)可用的电话号码[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)并申领这些号码。`Status` `ACTIVE`

在向流量分配组申领电话号码之前，我们建议您使用 [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)API 验证流量分配组的状态是否为`ACTIVE`。将电话号码分配给非 `ACTIVE` 的流量分配组会导致 `ResourceNotFoundException`。

在调用 API 时，您可以在**TargetArn**参数中提供流量分配组 ARN，从而向流量分配组申领电话号码。[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)您还可以使用 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)API 将之前向实例申领的电话号码分配给流量分配组。

**注意**  
要更新**描述**字段，必须使用 Amazon Connect 控制台。

## 工作流示例
<a name="example-workflow-claim"></a>

以下是申请电话号码并跨多个 AWS 区域使用这些号码的工作流示例：

1. 创建实例的副本：

   1. 调用 [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API。

1. 创建将这些实例链接在一起的流量分配组：

   1. 调用 [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API。

1. 查找可向您的流量分配组申请的可用电话号码：

   1. 在创建流量分配组的区域中调用 [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)API。为 `TargetArn` 参数提供流量分配组 ARN。

1. 在创建流量分配组的区域中，调用 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)API：

   1. 为 `TargetArn` 参数提供流量分配组 ARN。

   1. 提供步骤 3 中 [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)API 调用返回的 E164 电话号码值。

   将会返回 `PhoneNumberId` 和 `PhoneNumberArn`。您可以将这些值用于后续操作。

1. 验证电话号码状态是否为 `CLAIMED`：

   1. 调用 [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html) API。

     （也DescribePhoneNumber 可以在与流量分配组关联的其他区域中调用。 它将返回相同的电话号码详细信息。）

   只有在电话号码的状态为 `CLAIMED` 之后，才可以由后续操作使用该电话号码。

   有关可能状态的说明，请参阅[已定义电话号码状态](#claim-phone-number-status)。

1. 对需要向流量分配组申请的所有电话号码重复步骤 3-5。

1. 执行以下步骤，以将流与电话号码相关联。在流量分配组运作的两个区域均这样做。

   这些步骤可确保您的电话流量正确路由到您的流，以支持您的流量分配配置。

   1. 在创建流量分配组的区域的现有 Amazon Connect 实例中，执行以下步骤：

      1. 调用 [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html)API。提供与所复制的实例相对应的 `InstanceId`。

      1. 返回流程 ARNs 列表。使用这些流程 ARNs将流程与电话号码相关联；调用 [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)API。

   1. 在其他 AWS 区域复制的 Amazon Connect 实例中，执行以下步骤：

      1. 调用 [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html)API。提供与所复制的实例相对应的 `InstanceId`。

      1. 返回流程 ARNs 列表。使用这些流程 ARNs将流程与电话号码相关联；调用 [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)API。

## 为什么 ClaimPhoneNumber 通话失败
<a name="why-claimphonenumber-fails"></a>

`ResourceNotFoundException`在以下情况下，您[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)的 API 调用将失败，并显示为：
+ 指定的流量分配组不存在、流量分配组的状态并非 `ACTIVE`，或者您没有流量分配组的所有权。
+ 该电话号码不可申请。在某些情况下，从中找到的电话号码[SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)可能已被其他客户申领。

[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)在以下情况下，将因`InvalidParameterException`错误而失败：
+ 您要调用的端点不在创建流量分配组的同一区域中。

## 已定义电话号码状态
<a name="claim-phone-number-status"></a>

以下是电话号码状态的描述：
+ `CLAIMED`表示前一个[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)或[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)操作成功。
+ `IN_PROGRESS`表示 a [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)，[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)操作仍在进行中，尚未完成。您可以稍后[DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html)致电以验证之前的操作是否已完成。
+ `FAILED`表示之前的[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)或[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)操作已失败。它包括一条消息，指示失败原因。

   失败的一个常见原因是您申请电话号码或将其更新为的 `TargetArn` 值已达到其申请总数的限制。

  如果您收到来自 `ClaimPhoneNumber` API 调用的 `FAILED` 状态，则在电话号码被释放回清单供其他客户申请之前，您有一天的时间可以再次申请该电话号码。