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

# 在 Connect Customer 中将申领的电话号码分配给流量分配组
<a name="assign-phone-numbers-traffic-distribution-groups"></a>
+ 您创建了一个新的流量分配组，其状态为 `ACTIVE`。我们建议使用 [ DescribeTrafficDistributionGroup ](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API 来验证状态。
+ 您已经向实例或其他流量分配组申请电话号码。

 现在，您可以使用 [ UpdatePhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API 将这些申领的电话号码分配给新的流量分配组。在 `TargetArn` 参数中提供流量分配组 ARN。

**注意**  
要更新 “**描述” ** 字段，必须使用 “连接客户” 控制台。

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

以下是将申请的电话号码分配给您的流量分配组的工作流示例：

1. 调用 [ UpdatePhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API 将电话号码分配给新`TargetArn`的。

   `TargetArn`可以用于另一个 Connect Customer 实例，也可以用于在最初申领电话号码的同一地区创建的流量分配组。

1. 执行以下步骤，以将流与电话号码相关联。

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

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

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

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

   与流量关联的电话号码将在跨 AWS 区域的 Connect 客户实例之间镜像。

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

如果该号码是向流量分配组申领的，并且您[AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)使用创建流量分配组的实例进行呼叫，则可以为 `PhoneNumberId` URI 请求参数使用完整的电话号码 ARN 或 UUID 值。 AWS 区域 

但是，如果该号码是向流量分配组申领的，并且您使用与流量分配组 AWS 区域 关联的副本中的实例调用此 API，则必须提供完整的电话号码 ARN。如果在这种情况下提供了 UUID，您会收到 `ResourceNotFoundException`。

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

`ResourceNotFoundException`在以下情况下，您[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)的 API 调用将失败，并显示为：
+ 指定的流量分配组不存在、流量分配组的状态并非 `ACTIVE`，或者您没有流量分配组的所有权。

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

## 已定义电话号码状态
<a name="update-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` 值已达到其申请总数的限制。