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

# Amazon Connect インスタンスのトラフィック分散グループを作成する
<a name="setup-traffic-distribution-groups"></a>

[CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API を使用して、既存の Amazon Connect インスタンスのトラフィック分散グループを作成できます。

*トラフィック分散グループ*は、異なる AWS リージョンにある Amazon Connect インスタンスをリンクできる Amazon Connect リソースです。電話番号をトラフィック分散グループに関連付けることができます。これらの番号へのトラフィックは、トラフィック分散グループ内のインスタンス間で分散できます。

## 重要事項
<a name="important-tips-tdg"></a>
+ トラフィック分散グループを作成するときには、ソースの AWS リージョンに作成する必要があります。*ソースリージョン*とは、既存の Amazon Connect インスタンスをセットアップしたリージョンです。
+ 電話番号をトラフィック分散グループに関連付ける場合:
  + ソースリージョンに登録済みの電話番号のみを関連付けることができます。
  + 電話番号は、トラフィック分散グループが作成されたのと同じリージョンに存在する必要があります。
+ トラフィック分散グループに番号を登録したり、トラフィック分散グループのトラフィック分散を取得または更新したりできるのは、`Status` が `ACTIVE` の場合だけです。[DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API を使用して、トラフィック分散グループが正常に作成された (`Status` が `ACTIVE`) かどうかを判断します。
+ レプリカ Amazon Connect インスタンスを作成すると、そのインスタンス用のデフォルトのトラフィック分散グループが作成されます。デフォルトのトラフィック分散グループは、`SignInConfig` 分散を変更できる唯一のトラフィック分散グループです。[TrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_TrafficDistributionGroup.html) データタイプの `IsDefault` パラメータを参照してください。`SignInConfig` を使用して、Amazon Connect インスタンスにサインインしやすくなるように、使用するバックエンドのサインインサーバーを選択します。たとえば、変更した `SignInConfig` とデフォルトでない `TrafficDistributionGroup` を使用して `UpdateTrafficDistribution` に電話をかけた場合、`InvalidRequestException` が返されます。

## トラフィック分散グループのステータス
<a name="tdg-statuses"></a>

次に、トラフィック分散グループのステータスについて説明します。
+ `CREATION_IN_PROGRESS`: トラフィック分散グループを作成中です。
+ `ACTIVE`: トラフィック分散グループが作成されました。
+ `CREATION_FAILED`: トラフィック分散グループの作成に失敗しました。
+ `PENDING_DELETION`: トラフィック分散グループの削除中。
+ `DELETION_FAILED`: トラフィック分散グループの削除に失敗しました。
+ `UPDATE_IN_PROGRESS`: トラフィック分散グループの更新中。

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

[CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API 呼び出しは、次の場合に `InvalidRequestException` で失敗します。
+ [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API が、リンクされたインスタンスのトラフィック分散グループを作成する前に呼び出されませんでした。
+ [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API が、[ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API が呼び出されたのと同じリージョンで呼び出されませんでした。この API が呼び出されるリージョンは、レプリカの作成に使用されたインスタンスのリージョンと一致する必要があります。