翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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 を指定します。

**注記**  
Description ****フィールドを更新するには、Connect Customer コンソールを使用する必要があります。

## ワークフローの例
<a name="example-workflow-assign"></a>

以下は、登録済み電話番号をトラフィック分散グループに割り当てるワークフローの例です。

1. [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API を呼び出して、電話番号を新しい `TargetArn` に割り当てます。

   は、別の Connect Customer インスタンスの場合も、電話番号が最初に要求されたのと同じリージョンで作成されたトラフィック分散グループの場合も`TargetArn`かまいません。

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 を呼び出します。

   フローの関連付けに使用する電話番号は、Connect Customer インスタンス間で AWS リージョン間でミラーリングされます。

## AssociatePhoneNumberContactFlow 呼び出しが失敗する理由
<a name="why-associatephonenumbercontactflow-fails"></a>

番号がトラフィック分散グループに要求され、トラフィック分散グループが作成された のインスタンスを使用して [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html) AWS リージョン を呼び出す場合は、URI リクエストパラメータに完全な電話番号 ARN または UUID `PhoneNumberId` 値を使用できます。

ただし、番号がトラフィック分散グループに要求され、トラフィック分散グループ AWS リージョン に関連付けられたレプリカ内のインスタンスを使用してこの API を呼び出す場合は、完全な電話番号 ARN を指定する必要があります。このシナリオで UUID を指定すると、`ResourceNotFoundException` が発生します。

## UpdatePhoneNumber の呼び出しが失敗する理由
<a name="why-updatephonenumber-fails"></a>

[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API の呼び出しは、以下の場合、`ResourceNotFoundException` で失敗します。
+ 指定したトラフィック分散グループが存在しない、トラフィック分散グループのステータスが `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` は、[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` の値が、登録件数の上限に達したことです。