翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS リージョン間で Amazon Connect エージェントワークスペースのエージェントディストリビューションを更新する
`UpdateTrafficDistribution` API を、[テレフォニートラフィックをリージョン間で分散](update-telephony-traffic-distribution.md)するのに使用できるように、 AWS リージョン全体に分散させるのににも使えます。これは、通常の定期的な運用準備テストの一環として完全に、または段階的に実施します。たとえば、ある AWS リージョンにエージェントの 40% を保持してアクティブな問い合わせを完了し、残りのエージェントをレプリカリージョンにシフトできます。
**注記**
テレフォニートラフィックをシフトする際は、他のリージョンで通話を処理できるように、エージェントやエージェントのサインインもシフトします。エージェントをシフトしない場合、音声通話はシフトされたリージョンに送信されますが、通話を受信できるエージェントがいない状況になります。
トラフィック分散グループにエージェントを追加した後、[UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html) API を使用して、特定のトラフィック分散グループのリンクされたインスタンス全体にエージェントを 10% 単位で分散させます。エージェントはリージョン間を移動する前にアクティブな音声コンタクトを完了できます。
**注記**
エージェントがリージョンを移動する前にコンタクトを終了しようとしてエラーが発生した場合は、エージェントワークスペースページを更新する必要があります。詳細については、「[AWS リージョン間でのエージェントのシフトをサポートするように Amazon Connect エージェントワークスペースを設定する](setup-agentworkspace-switchover.md)」を参照してください。
**Topics**
+ [要件](#update-agent-traffic-distribution-requirements)
+ [通常のオペレーション中に両方のリージョンを有効にする](#change-signin-weights)
+ [すべてのテレフォニートラフィックとエージェントを AWS リージョン間でシフトする方法](#shift-all-traffic)
+ [リージョンスイッチ UI バナー](#regional-switch-ui-banner)
## 要件
以下の要件が満たされない場合、[UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html) API の呼び出しは `InvalidRequestException` で失敗します。
1. 指定されたトラフィック分散グループが存在する必要があります。
1. トラフィック分散グループのステータスは `ACTIVE` である必要があります。
1. `SignInConfig` 分散を変更する場合、デフォルトのトラフィック分散グループに対してのみ実行できます。レプリカ Amazon Connect インスタンスを作成すると、デフォルトのトラフィック分散グループが作成されます。[TrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_TrafficDistributionGroup.html) データタイプの `IsDefault` パラメータを参照してください。
ソースの AWS リージョンから `UpdateTrafficDistribution` を呼び出す場合、トラフィック分散グループ ID または Amazon リソースネーム (ARN) のいずれかを使用できます。レプリカリージョンで `UpdateTrafficDistribution` を呼び出す場合、トラフィック分散グループ ARN を使用する必要があります。
## 通常のオペレーション AWS リージョン 中に両方を有効にする
`UpdateTrafficDistribution` API には `SignInConfig` という分散が含まれています。こうすることにより、Amazon Connect インスタンスにサインインしやすくなるように、使用するバックエンドのサインインサーバーを選択できます。トラフィック分散グループで設定された `SignInConfig` に関係なく、エージェントはトラフィック分散グループの両方のインスタンスにサインインします。
最良のエクスペリエンスを得るには、通常のオペレーション中に両方の AWS リージョンを有効にすることをお勧めします。これを達成するには、`true` を両方の `SignInConfig` 分散に渡します。テレフォニートラフィックとエージェント全体を 1 つの AWS リージョンにまたがって移行する必要がある場合は、トラフィックを移行するリージョン`false`の `SignInConfig`を に変更することをお勧めします。
たとえば、次のコールでは、ID プロバイダーからの特定のログイン呼び出しについて、エージェントが us-west-2 サインインサーバーを使用する確率が 50%、us-east-1 サインインサーバーを使用する確率が 50% になります。
```
aws connect update-traffic-distribution \
--id traffic distribution group ID or ARN \
--cli-input-json \
'{
"SignInConfig":{
"Distributions":[
{
"Region":"us-west-2",
"Enabled":true
},
{
"Region":"us-east-1",
"Enabled":true
}
]
}
}'
```
逆に、以下のサインイン分散は、サインインエンドポイント上のトラフィックの 100% を us-east-1 サインインサーバーを使用するようにルーティングします。
```
aws connect update-traffic-distribution \
--id traffic distribution group ID or ARN \
--cli-input-json \
'{
"SignInConfig":{
"Distributions":[
{
"Region":"us-west-2",
"Enabled":false
},
{
"Region":"us-east-1",
"Enabled":true
}
]
}
}'
```
この分散は、インスタンスグループ内の両方のインスタンスへのエージェントのログインを容易にするために、サインインサーバーのどのリージョンのみを使用するかを制御します。`UpdateTrafficDistribution` API の `AgentConfig` 部分によりコントロールされるエージェントの分散ンには影響しません。の一部API。
**重要**
エージェントのサインイン中にサインインエンドポイントが応答しない場合、`SignInConfig` 分散が複数のリージョンに分かれている場合は、分散 1 つの AWS リージョンに変更することでエラーを解決できます。または、`SignInConfig` が 1 つのリージョンに重み付けており反応しない場合、`SignInConfig` を 無効になっているリージョンへシフトしています。`SignInConfig` の設定に関係なく、エージェントは両方のリージョンで Amazon Connect インスタンスにサインインしようとするため、ソースリージョンとレプリカリージョンの両方でセッションをアクティブにしておくとメリットがあります。
## すべてのテレフォニートラフィックとエージェントを AWS リージョン間でシフトする方法
新しいインバウンド音声問い合わせ、エージェントログイン分散、およびエージェント分散のすべてを us-west-2 から us-east-1 に移行するには、次のコードスニペットを使用します。
```
aws connect update-traffic-distribution \
--id traffic distribution group ID or ARN \
--cli-input-json \
'{
"SignInConfig":{
"Distributions":[
{
"Region":"us-west-2",
"Enabled":false
},
{
"Region":"us-east-1",
"Enabled":true
}
]
},
"AgentConfig":{
"Distributions":[
{
"Region":"us-west-2",
"Percentage":0
},
{
"Region":"us-east-1",
"Percentage":100
}
]
},
"TelephonyConfig":{
"Distributions":[
{
"Region":"us-west-2",
"Percentage":0
},
{
"Region":"us-east-1",
"Percentage":100
}
]
}
}
'
```
ソースの AWS リージョンから `UpdateTrafficDistribution` を呼び出す場合、トラフィック分散グループ ID または Amazon リソースネーム (ARN) のいずれかを使用できます。レプリカリージョンで `UpdateTrafficDistribution` を呼び出す場合、トラフィック分散グループ ARN を使用する必要があります。
## リージョンスイッチ UI バナー
エージェントワークスペースと CCP は、リージョンスイッチを強調表示する UI バナーを提供します。
トラフィック分散グループ (TDG) の調整によってリージョンが変更されたときにエージェントが**コンタクト中**である場合、次のようなバナーが表示されます。音声コンタクトを完了して ACW 状態を閉じると、エージェントは自動的に新しいリージョンに更新されます。アクションは必要ありません。エージェントがコンタクトを閉じられない場合は、**バックアップで続行**を選択すると、別のリージョンに切り替えるための確認を求めるポップアップが表示されます。
これを反映するようにランブックとエージェントトレーニングガイドを調整することをお勧めします。
