翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon Connect インスタンスのトラフィック分散グループを作成する
CreateTrafficDistributionGroup API を使用して、既存の Amazon Connect インスタンスのトラフィック分散グループを作成できます。
トラフィック分散グループは、異なる AWS リージョンにある Amazon Connect インスタンスをリンクできる Amazon Connect リソースです。電話番号をトラフィック分散グループに関連付けることができます。これらの番号へのトラフィックは、トラフィック分散グループ内のインスタンス間で分散できます。
重要事項
-
トラフィック分散グループを作成するときには、ソースの AWS リージョンに作成する必要があります。ソースリージョンとは、既存の Amazon Connect インスタンスをセットアップしたリージョンです。
-
電話番号をトラフィック分散グループに関連付ける場合:
-
ソースリージョンに登録済みの電話番号のみを関連付けることができます。
-
電話番号は、トラフィック分散グループが作成されたのと同じリージョンに存在する必要があります。
-
-
トラフィック分散グループに番号を登録したり、トラフィック分散グループのトラフィック分散を取得または更新したりできるのは、
Status
がACTIVE
の場合だけです。DescribeTrafficDistributionGroup API を使用して、トラフィック分散グループが正常に作成された (Status
がACTIVE
) かどうかを判断します。 -
レプリカ Amazon Connect インスタンスを作成すると、そのインスタンス用のデフォルトのトラフィック分散グループが作成されます。デフォルトのトラフィック分散グループは、
SignInConfig
分散を変更できる唯一のトラフィック分散グループです。TrafficDistributionGroup データタイプのIsDefault
パラメータを参照してください。SignInConfig
を使用して、Amazon Connect インスタンスにサインインしやすくなるように、使用するバックエンドのサインインサーバーを選択します。たとえば、変更したSignInConfig
とデフォルトでないTrafficDistributionGroup
を使用してUpdateTrafficDistribution
に電話をかけた場合、InvalidRequestException
が返されます。
トラフィック分散グループのステータス
次に、トラフィック分散グループのステータスについて説明します。
-
CREATION_IN_PROGRESS
: トラフィック分散グループを作成中です。 -
ACTIVE
: トラフィック分散グループが作成されました。 -
CREATION_FAILED
: トラフィック分散グループの作成に失敗しました。 -
PENDING_DELETION
: トラフィック分散グループの削除中。 -
DELETION_FAILED
: トラフィック分散グループの削除に失敗しました。 -
UPDATE_IN_PROGRESS
: トラフィック分散グループの更新中。
CreateTrafficDistributionGroup 呼び出しが失敗する理由
CreateTrafficDistributionGroup API 呼び出しは、次の場合に InvalidRequestException
で失敗します。
-
ReplicateInstance API が、リンクされたインスタンスのトラフィック分散グループを作成する前に呼び出されませんでした。
-
CreateTrafficDistributionGroup API が、ReplicateInstance API が呼び出されたのと同じリージョンで呼び出されませんでした。この API が呼び出されるリージョンは、レプリカの作成に使用されたインスタンスのリージョンと一致する必要があります。