翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Connect グローバルレジリエンシーの使用開始
**重要**
Amazon Connect 2021 年 3 月 31 日より前に作成された インスタンスには、次の形式のドメインが割り当てられました。
```
https://your-instance-alias.awsapps.com/connect/
```
ドメインが古い形式を使用している場合、 Amazon Connect グローバルレジリエンシーの機能を適切に設定することはできません。この機能を有効にするには、[ドメインを新しい形式に更新](update-your-connect-domain.md)する必要があります。
```
https://your-instance-alias.my.connect.aws/
```
**注記**
**初めて使用する場合** [Amazon Connect グローバルレジリエンシーのワークショップ](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US)を参照してください。このオンラインコースでは、AWS CLI を通じて新しい API を使用した電話番号とエージェントのフェイルオーバーをオンボーディングおよびテストするプロセスについて説明します。
グローバルレジリエンシーは、米国東部 (バージニア北部）、米国西部 (オレゴン）、アジアパシフィック (大阪）、アジアパシフィック (東京）、欧州 (フランクフルト）、欧州 (ロンドン) の各 AWS リージョンで作成された Amazon Connect インスタンスでのみ使用できます。
米国東部 (バージニア北部) リージョンでレプリカを作成できるのは、ソースが米国西部 (オレゴン) の場合のみで、その逆も同様です。
欧州 (フランクフルト) リージョンでレプリカを作成できるのは、ソースが欧州 (ロンドン) の場合のみで、その逆も同様です。
アジアパシフィック (大阪) でのレプリカ作成は、レプリケート元がアジアパシフィック (東京) の場合にのみ行えます。
この機能を利用するには、Amazon Connect ソリューションアーキテクトまたはテクニカルアカウントマネージャーにお問い合わせください。
Amazon Connect グローバルレジリエンシーの使用を開始するには、別の に既存の Amazon Connect インスタンスのレプリカを作成し AWS リージョン、トラフィック分散グループを作成します。
*トラフィック分散グループ*は、異なる AWS リージョンにある Amazon Connect インスタンスをリンクできる Amazon Connect リソースです。電話番号をトラフィック分散グループに関連付けることができます。これらの番号へのトラフィックは、トラフィック分散グループ内のインスタンス間で分散できます。
## Amazon Connect グローバルレジリエンシーのセットアップ方法
1. [既存の Amazon Connect インスタンスのレプリカを作成します](create-replica-connect-instance.md)。[ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API を使用します。
1. [トラフィック分散グループを作成します](setup-traffic-distribution-groups.md)。
1. [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API を使用します。
1. [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API を使用して、トラフィック分散グループが正常に作成された (`Status` が `ACTIVE`) かどうかを判断します。
1. [トラフィック分散グループに電話番号を登録します](claim-phone-numbers-traffic-distribution-groups.md)。トラフィック分散グループが正常に作成されると (`Status` が `ACTIVE`)、[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API を使用して、そのグループに電話番号を登録できます。
**注記**
これらの電話番号のデフォルトのトラフィック配分は 100%～0% に設定されます。つまり、インバウンドのテレフォニートラフィックの 100% は、レプリカの作成に使用されたソース Amazon Connect インスタンスに送られます。
さらに、電話番号がインスタンスに登録されたら、その電話番号を AWS リージョン間の複数のインスタンスに割り当てることができます。そのためには、[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API を使用して、トラフィック分散グループに番号を割り当てます。
1. [トラフィック分散を更新します](update-telephony-traffic-distribution.md)。[UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html) API を使用して、リンクされたインスタンス間で 10% 単位でトラフィックを分散します。
# 既存の Amazon Connect インスタンスのレプリカを作成する
**注記**
**初めて使用する場合** [Amazon Connect グローバルレジリエンシーのワークショップ](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US)を参照してください。このオンラインコースでは、AWS CLI を通じて新しい API を使用した電話番号とエージェントのフェイルオーバーをオンボーディングおよびテストするプロセスについて説明します。
グローバルレジリエンシーは、米国東部 (バージニア北部）、米国西部 (オレゴン）、アジアパシフィック (大阪）、アジアパシフィック (東京）、欧州 (フランクフルト）、欧州 (ロンドン) の各 AWS リージョンで作成された Amazon Connect インスタンスでのみ使用できます。
米国東部 (バージニア北部) リージョンでレプリカを作成できるのは、ソースが米国西部 (オレゴン) の場合のみで、その逆も同様です。
欧州 (フランクフルト) リージョンでレプリカを作成できるのは、ソースが欧州 (ロンドン) の場合のみで、その逆も同様です。
アジアパシフィック (大阪) でのレプリカ作成は、レプリケート元がアジアパシフィック (東京) の場合にのみ行えます。
この機能を利用するには、Amazon Connect ソリューションアーキテクトまたはテクニカルアカウントマネージャーにお問い合わせください。
[ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API を呼び出して、別の に Amazon Connect インスタンスのレプリカを作成し AWS リージョン 、Amazon Connect リソースの設定情報をコピーします AWS リージョン。
**Topics**
+ [重要事項](#important-info-automated-config)
+ [レプリカインスタンスの特性](#replica-characteristics)
+ [レプリカインスタンスでミラーリングされるリソース](#mirrored-resources)
+ [レプリカインスタンスが作成された後に実行すべきこと](#configure-replica-instance)
+ [AWS サポートに連絡すべきケース](#replica-cs)
+ [ReplicateInstance 呼び出しが失敗する理由](#why-replicateinstance-fails)
+ [インスタンスのソースリージョンを検索します。](#how-to-find-source-region-of-instances)
## 重要事項
+ [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) を実行する前に、次を行います。
+ インスタンスの作成に最低限必要な IAM アクセス許可があるかを確認します。「[カスタム IAM ポリシーを使用して Amazon Connect コンソールへのアクセスを管理するために必要なアクセス許可](security-iam-amazon-connect-permissions.md)」を参照してください。
+ フローを更新して、ハードコードされたリージョンはすべて `$.AwsRegion` または `$['AwsRegion']` パラメータに置き換えます。上記のパラメータは、フローの実行時にフローが実行されるリージョンに置き換えられます。
+ AWS リージョン 全体にわたり、Lambda 関数の名前が同じであることを確認します。
+ Amazon Lex ボットでは、次のいずれかを実行できます。
+ Amazon Lex グローバルレジリエンシーを使用して、 AWS リージョン間でボットを複製し、ボット ID を保持します。
+ フローを実行している AWS リージョンに基づいて分岐するようにフローを変更します。以下の例で示すように、これらのパラメータは、フローの実行時にフローが実行されるリージョンに置き換えられます。
![\[[コンタクト属性の確認] ブロックのプロパティページ\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/acgr-requirements.png)
+ レプリカインスタンス AWS マネージドキー で を許可するには、 AWS コンソールを使用して、レプリカインスタンスを作成する予定のリージョンに一時的な Amazon Connect インスタンスを作成します。これにより、Amazon Connect AWS マネージドキー のデフォルトが作成されます。
+ [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) は、最初のレプリケーションプロセスの一環として、 AWS リージョン 全体にわたり Amazon Connect 設定をコピーします。この最初のステップが完了すると、後で元のリソースまたは[ミラーリソース](#mirrored-resources)に加えられた変更は継続的に同期されます。これは、ソースからレプリカ、レプリカからソースの両方向で発生します。
+ ソースインスタンスの電話番号のうち、まだ番号グループに関連付けられていない番号はすべて、デフォルトのトラフィック分散グループに自動的に追加されます。このステップにより、ソースリージョンとレプリカリージョンの両方で電話番号を使用できるようになり、電話番号とフローの関連付けを AWS リージョン全体にわたりミラーリングできるようになります。
+ アジアパシフィック (東京) のインスタンスでは、Amazon Connect グローバルレジリエンシー (ACGR) に対して明示的に有効になっている電話番号のみが、アジアパシフィック (大阪) への完全なレプリケーション動作をサポートします。アジアパシフィック (大阪) 経由でルーティングする場合、インバウンドコールの配信時間は最大 20 秒になることがあります。
+ レプリカインスタンスにログインするための緊急アクセスは、デフォルトのルーティングプロファイルとキューがリージョン全体にわたりミラーリングされた後にのみ利用できるようになります。
+ 設定が伝播されると AWS リージョン、 AWS CloudTrail ログで進行状況を表示できます。または、 Amazon Connect 管理者ウェブサイトで、**ユーザー管理****「履歴の変更を表示**」に移動して、ユーザーへの変更の監査証跡を表示できます。監査証跡は、他の設定でも使用できます。
+ CloudTrail ログには、設定ミラーリングに影響を与えない次のエラーが表示される場合があります。
+ Http 409 (競合) エラー: これらのエラーは、同じコンタクトセンターリソースに対して行われた複数の設定更新を連続して処理する際に、ミラーリングの競合が原因で発生します。これらのエラーはログに表示される可能性がありますが、コンタクトセンターリソースの実際のミラーリングには影響はありません。
+ ソースインスタンスとレプリカインスタンスのリソース名は同じでもリソース ID が異なる場合、リソース名の競合が発生します。例えばこれは、レプリカインスタンス内のリソースが、レプリケーションプロセスではなく手動で作成された場合などに発生する場合があります。
リソース名が競合する場合、[ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) はリージョン間でリソースを同期せず、その代わりに `ResourceConflictException` エラーとします。名前の競合を解決した後(例えば、レプリカインスタンス内のリソースを削除した後)、もう一度 `ReplicateInstance` を実行してリソースを同期できます。
+ `ReplicateInstance` を実行した後、[AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html) API を使用して、エージェントをデフォルトのトラフィック分散グループ、またはカスタムトラフィック分散グループに関連付ける必要があります。
+ [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) を実行しても、Lambda 関数や Amazon Lex ボット、またはその他のサードパーティーまたは統合は同期されません。
## レプリカインスタンスの特性
+ レプリカの Amazon Connect インスタンスは、既存の Amazon Connect インスタンスと同じ AWS アカウントで作成されます。
+ [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) は、デフォルトのトラフィック分散グループがまだ存在しない場合は、トラフィック分散グループを作成します。フォルトのトラフィック分散グループには、次の 3 種類のトラフィック分散があります。
+ サインイン
+ [エージェント]
+ テレフォニー
[CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API を使用してトラフィック分散グループをさらに作成してください。ただし、これらの追加のトラフィック分散グループはデフォルトのトラフィック分散グループではないため、エージェント分散とテレフォニー分散のみがサポートされます。
+ デフォルトのトラフィック分散グループは、`SignInConfig` 分散を変更できる唯一のトラフィック分散グループです。[TrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_TrafficDistributionGroup.html) データタイプの `IsDefault` パラメータを参照してください。
+ `SignInConfig` を使用して、Amazon Connect インスタンスにサインインしやすくなるように、バックエンドのサインインサーバーを選択します。たとえば、変更した `SignInConfig` とデフォルトでない `TrafficDistributionGroup` を使用して `UpdateTrafficDistribution` に電話をかけた場合、`InvalidRequestException` が返されます。
+ レプリカのインスタンス ID は、レプリケート元の Amazon Connect インスタンスと同じです。
## レプリカインスタンスでミラーリングされるリソース
[ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) は、 AWS リージョン全体にわたり、次の Amazon Connect リソースをミラーリングします。
**重要**
このようなリソースのサービスクォータは、リソースが AWS リージョン 全体にわたりミラーリングされる**前に自動的に照合されます。プリカインスタンス内のその他のクォータを増やすには、リクエストを送信してください。
+ エージェントの習熟度
+ フロー
+ フローモジュール
+ [ユーザー]
+ [ルーティングプロファイル]
+ [キュー]
+ セキュリティプロファイル
+ オペレーション時間
+ クイック接続
+ 事前定義された属性
+ プロンプト (S3 に保存されているものは除く)
+ ユーザー階層 (グループとレベル)
+ エージェントステータス
+ 事前定義された属性
+ [保存されたレポート]
+ ビュー
+ データテーブル
+ WorkSpaces
+ フローモジュールのバージョン
+ フローモジュールのエイリアス
+ カスタムメトリクス
+ テストケース
+ 通知
**特定のリソースに関する重要な注意事項**
**保存済みレポート**: 保存済みレポートはレプリケートされますが、保存済みレポートに関連付けられたスケジュールはレプリケート*されません*。
**ビュー**: *公開*状態のビューのみがレプリケートされます。ドラフト状態のビューはレプリケート*されません*。
**データテーブル**: リテラル ARN 参照を含むデータテーブル値は、レプリケート時にリージョンコードをローカルリージョンに自動的に調整します。式を使用して構築ARNs は、リージョンコードを自動的に調整しない場合があります。
[ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) は、 AWS リージョン全体にわたり、次の関連付けもレプリケートします。
+ フローの電話番号
+ ルーティングプロファイルへのキュー
+ ユーザーからセキュリティプロファイル、ルーティングプロファイル、ユーザー階層
+ [ルーティングプロファイル]
+ クイック接続のキュー
+ オペレーション時間のキュー
+ フローのキュー
**注記**
最初のレプリケーション後、設定変更はレプリケートされたインスタンス間で、ほぼリアルタイムで双方向にレプリケートされます。失敗した場合、Amazon Connect グローバルレジリエンシーは 30 分以内に更新の同期を試みます。
## レプリカインスタンスが作成された後に実行すべきこと
レプリカの Amazon Connect インスタンスが作成されたら、それを設定する必要があります。
1. リージョン間でフロントエンドとバックエンドの統合 (SSO、Lambda、Lex など) の冗長性を確保します。
1. リンクされたインスタンス全体で、一致する手動更新を行います。
1. [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html) API を使用して、エージェントをデフォルトのトラフィック分散グループに関連付けます。
エージェントをトラフィック分散グループに関連付けるには、エージェントがソースインスタンスとレプリカインスタンスの両方に存在ｈしている必要があります。ソースインスタンスに新しく追加されて、レプリカにまだ配置されていないユーザーをトラフィック分散グループに関連付けることはできません。
## AWS サポートに連絡するタイミング
以下のアクティビティについては、 AWS サポートにお問い合わせください。
+ Amazon Connect 管理者ウェブサイトの CloudTrail ログと監査証跡で利用できるものを超えるミラーリングステータスを理解する。
## ReplicateInstance 呼び出しが失敗する理由
[ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API の呼び出しは、次の場合に `InvalidRequestException` で失敗します。
1. レプリカを作成するリージョンが、既存のインスタンスと同じリージョンです。
1. インスタンスが、別の [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API 呼び出しの一部として既にレプリケートされています。
1. インスタンスにエイリアスがありません。
1. インスタンスが `ACTIVE` ステータスではありません。
1. インスタンスで SAML が有効になっていません。
1. リソース名が競合しています。
## Amazon Connect インスタンスのソースリージョンを確認する方法
Amazon Connect インスタンスのソースリージョンがどのリージョンかわからない場合は、次の手順を実行して見つけてください。
1. [ListTrafficDistributionGroups](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListTrafficDistributionGroups.html) API に `InstanceId` で電話してください。
1. 応答リスト内の任意のトラフィック分散グループについて、返された `InstanceARN` にソースリージョンが含まれます。たとえば、次の ARN では、*source-region* は Amazon Connect インスタンスのリージョンになります。
`arn:aws:connect:source-region:account-id:traffic-distribution-group/ traffic-distribution-group-id`
# Amazon Connect インスタンスのトラフィック分散グループを作成する
[CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API を使用して、既存の Amazon Connect インスタンスのトラフィック分散グループを作成できます。
*トラフィック分散グループ*は、異なる AWS リージョンにある Amazon Connect インスタンスをリンクできる Amazon Connect リソースです。電話番号をトラフィック分散グループに関連付けることができます。これらの番号へのトラフィックは、トラフィック分散グループ内のインスタンス間で分散できます。
## 重要事項
+ トラフィック分散グループを作成するときには、ソースの 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` が返されます。
## トラフィック分散グループのステータス
次に、トラフィック分散グループのステータスについて説明します。
+ `CREATION_IN_PROGRESS`: トラフィック分散グループを作成中です。
+ `ACTIVE`: トラフィック分散グループが作成されました。
+ `CREATION_FAILED`: トラフィック分散グループの作成に失敗しました。
+ `PENDING_DELETION`: トラフィック分散グループの削除中。
+ `DELETION_FAILED`: トラフィック分散グループの削除に失敗しました。
+ `UPDATE_IN_PROGRESS`: トラフィック分散グループの更新中。
## CreateTrafficDistributionGroup 呼び出しが失敗する理由
[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 が呼び出されるリージョンは、レプリカの作成に使用されたインスタンスのリージョンと一致する必要があります。
# Amazon Connect を使用してトラフィック分散グループに電話番号を請求する
**注記**
**初めて使用する場合** [Amazon Connect グローバルレジリエンシーのワークショップ](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US)を参照してください。このオンラインコースでは、AWS CLI を通じて新しい API を使用した電話番号とエージェントのフェイルオーバーをオンボーディングおよびテストするプロセスについて説明します。
グローバルレジリエンシーは、米国東部 (バージニア北部）、米国西部 (オレゴン）、アジアパシフィック (大阪）、アジアパシフィック (東京）、欧州 (フランクフルト）、欧州 (ロンドン) の各 AWS リージョンで作成された Amazon Connect インスタンスでのみ使用できます。
米国東部 (バージニア北部) リージョンでレプリカを作成できるのは、ソースが米国西部 (オレゴン) の場合のみで、その逆も同様です。
欧州 (フランクフルト) リージョンでレプリカを作成できるのは、ソースが欧州 (ロンドン) の場合のみで、その逆も同様です。
アジアパシフィック (大阪) でのレプリカ作成は、レプリケート元がアジアパシフィック (東京) の場合にのみ行えます。
この機能を利用するには、Amazon Connect ソリューションアーキテクトまたはテクニカルアカウントマネージャーにお問い合わせください。
トラフィック分散グループが正常に作成されたら (`Status` が `ACTIVE`)、[SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) を使用して使用可能な電話番号を検索し、[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) を使用してその電話番号を取得します。
トラフィック分散グループに電話番号を登録する前に、[DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API を使用して、トラフィック分散グループのステータスが `ACTIVE` であることを確認することをお勧めします。`ACTIVE` ではないトラフィック分散グループに電話番号を割り当てると、`ResourceNotFoundException` になります。
[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API を呼び出すときに **TargetArn** パラメータにトラフィック分散グループ ARN を指定することで、トラフィック分散グループに電話番号を登録できます。[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API を使用して、以前にインスタンスに登録された電話番号をトラフィック分散グループに割り当てることもできます。
**注記**
**Description** (説明) フィールドを更新するには、Amazon Connect コンソールを使用する必要があります。
## ワークフローの例
以下は、複数の AWS リージョンに電話番号を登録して使用するワークフローの例です。
1. インスタンスのレプリカを作成します:
1. [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API を呼び出します。
1. これらのインスタンスをリンクするトラフィック分散グループを作成します:
1. [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API を呼び出します。
1. トラフィック分散グループに登録できる電話番号を検索します:
1. トラフィック分散グループが作成されたリージョンで [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) API を呼び出します。`TargetArn` パラメータにトラフィック分散グループの ARN を指定します。
1. トラフィック分散グループが作成されたリージョンで、[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API を呼び出します。
1. `TargetArn` パラメータにトラフィック分散グループの ARN を指定します。
1. ステップ 3 で [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) API 呼び出しによって返された E164 電話番号の値を指定します。
`PhoneNumberId` と `PhoneNumberArn` が返されます。これらの値は、フォローアップ操作に使用できます。
1. 電話番号のステータスが `CLAIMED` であることを確認します:
1. [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html) API を呼び出します。
(DescribePhoneNumber は、トラフィック分散グループに関連する他のリージョンでも呼び出すことができます。この場合、同じ電話番号の詳細が返されます。)
電話番号は、ステータスが `CLAIMED` になった後でのみ、フォローアップ操作で使用できます。
ステータスが取り得る値については、「[電話番号ステータスの定義](#claim-phone-number-status)」を参照してください。
1. トラフィック分散グループに登録する必要があるすべての電話番号について、ステップ 3～5 を繰り返します。
1. フローを電話番号に関連付けるには、以下のステップを実行します。トラフィック分散グループが動作する両方のリージョンで実行します。
これらのステップにより、テレフォニートラフィックがフローに正しくルーティングされ、トラフィック分散設定をサポートできるようになります。
1. トラフィック分散グループが作成されたリージョンの既存の Amazon Connect インスタンスで、以下のステップを実行します。
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 を呼び出します。
1. 他のリージョンのレプリケートされた Amazon Connect インスタンスで AWS 、次の手順を実行します。
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 を呼び出します。
## ClaimPhoneNumber 呼び出しが失敗する理由
[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API の呼び出しは、次の場合に `ResourceNotFoundException` で失敗します。
+ 指定したトラフィック分散グループが存在しない、トラフィック分散グループのステータスが `ACTIVE` ではない、またはトラフィック分散グループの所有権を持っていない。
+ 電話番号を登録に使用できない。場合によっては、[SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) で見つかった電話番号が、別の顧客によって登録された可能性があります。
[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) は、次の場合に `InvalidParameterException` で失敗します。
+ 呼び出しているエンドポイントが、トラフィック分散グループが作成されたリージョンとは異なります。
## 電話番号ステータスの定義
電話番号のステータスの説明は次のとおりです。
+ `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` の値が、登録件数の上限に達したことです。
`ClaimPhoneNumber` API の呼び出しから `FAILED` ステータスが返された場合、電話番号がインベントリに戻されて他の顧客が登録できるようになるまで 1 日待ってから、電話番号の登録を再試行する必要があります。
# 登録済み電話番号を Amazon Connect のトラフィック分散グループに割り当てる
+ 新しいトラフィック分散グループを作成し、ステータスは `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** (説明) フィールドを更新するには、Amazon Connect コンソールを使用する必要があります。
## ワークフローの例
以下は、登録済み電話番号をトラフィック分散グループに割り当てるワークフローの例です。
1. [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API を呼び出して、電話番号を新しい `TargetArn` に割り当てます。
`TargetArn` は、別の Amazon Connect インスタンス用でも、電話番号が最初に登録されたのと同じリージョンに作成されたトラフィック分散グループのものでもかまいません。
1. フローを電話番号に関連付けるには、以下のステップを実行します。
これらのステップにより、テレフォニートラフィックがフローに正しくルーティングされ、トラフィック分散設定をサポートできるようになります。
1. トラフィック分散グループが作成されたリージョンの既存の Amazon Connect インスタンスで、以下のステップを実行します。
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 リージョン間で Amazon Connect インスタンス間でミラーリングされます。
## AssociatePhoneNumberContactFlow 呼び出しが失敗する理由
番号がトラフィック分散グループに要求され、トラフィック分散グループが作成された のインスタンスを使用して [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html) AWS リージョン を呼び出す場合は、URI リクエストパラメータに完全な電話番号 ARN または UUID `PhoneNumberId` 値を使用できます。
ただし、番号がトラフィック分散グループに要求され、トラフィック分散グループ AWS リージョン に関連付けられたレプリカのインスタンスを使用してこの API を呼び出す場合は、完全な電話番号 ARN を指定する必要があります。このシナリオで UUID を指定すると、`ResourceNotFoundException` が発生します。
## UpdatePhoneNumber の呼び出しが失敗する理由
[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` エラーで失敗します。
+ 呼び出しているエンドポイントが、トラフィック分散グループが作成されたリージョンとは異なります。
## 電話番号ステータスの定義
電話番号のステータスの説明は次のとおりです。
+ `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` の値が、登録件数の上限に達したことです。
# Amazon Connect インスタンスと 間のテレフォニートラフィック分散を更新する AWS リージョン
[UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html) API を使用して、テレフォニートラフィックを配信し、リージョン全体で[エージェントをシフト](update-agents-across-regions.md)します。
**注記**
テレフォニートラフィックをシフトする際は、他のリージョンで通話を処理できるように、エージェントやエージェントのサインインもシフトします。エージェントをシフトしない場合、音声通話はシフトされたリージョンに送信されますが、通話を受信できるエージェントがいない状況になります。
トラフィック分散グループに電話番号を登録した後、[UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html) API を使用して、特定のトラフィック分散グループのリンクされたインスタンス全体にインバウンド音声問い合わせを 10% 単位で分散させることができます。
以下の要件が満たされない場合、[UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html) API コールは `InvalidRequestException` で失敗します。
+ テレフォニートラフィックの設定の分散を指定する必要があります。
+ リンクされた両方のインスタンスについてトラフィック分散を指定する必要があり、分散の合計が 100% になる必要があります。
+ トラフィック分散は 10% 単位で指定する必要があります。
+ テレフォニー設定で指定されたインスタンス ARN は、リンクされたインスタンスの ARN と一致する必要があります。
ソースの AWS リージョンから `UpdateTrafficDistribution` を呼び出す場合、トラフィック分散グループ ID または Amazon リソースネーム (ARN) のいずれかを使用できます。レプリカリージョンで `UpdateTrafficDistribution` を呼び出す場合、トラフィック分散グループ ARN を使用する必要があります。
# Amazon Connect Global Resiliency を使用してエージェントのエクスペリエンスを設定します。
Amazon Connect グローバルレジリエンシーでは、グローバルサインイン、エージェント分散 API、エージェントワークスペースの強化により、エージェントにグローバルなエクスペリエンスを提供できます。この一連の機能により、次のことが可能になります。
+ エージェントが 1 日の始めに 1 回サインインすれば、どのリージョンがアクティブかをいつでも把握しなくても、現在のアクティブなリージョンの問い合わせ先を処理できます。
+ トラフィック分散グループにエージェントを追加し、AWS リージョン全体にエージェントを分散します。
+ ページを更新するだけで、新しいインバウンド音声問い合わせを現在アクティブなリージョンのエージェントワークスペースにリダイレクトします。
**Topics**
+ [IdP を Amazon Connect Amazon Connect グローバルレジリエンシー SAML サインインエンドポイントと統合する](integrate-idp.md)
+ [複数の AWS リージョンのインスタンスにエージェントを関連付ける](associate-agents-across-regions.md)
+ [リージョン全体でエージェント分散を更新する](update-agents-across-regions.md)
+ [エージェントワークスペースをセットアップする](setup-agentworkspace-switchover.md)
+ [エージェントをリージョン間でシフトする際の問題を回避するためのヒント](possible-issues-shifting-regions.md)
# ID プロバイダー (IdP) を Amazon Connect Amazon Connect グローバルレジリエンシー SAML サインインエンドポイントと統合する
エージェントが一度サインインし、両方の AWS リージョンにログインして現在のアクティブなリージョンからの問い合わせを処理するには、グローバルサインイン SAML エンドポイントを使用するように IAM 設定を構成する必要があります。
## [開始する前に]
Amazon Connect Global Resiliency を使用するには、Amazon Connect インスタンスの SAML を有効にする必要があります。IAM フェデレーションの詳細については、「[SAML 2.0 フェデレーティッドユーザーに AWS マネジメントコンソールへのアクセスを許可する](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_enable-console-saml.html)」を参照してください。
## 重要事項
+ エージェントフェイルオーバーは、グローバルサインインエンドポイントを使用する場合にのみサポートされます。
+ このトピックのステップを実行するには、インスタンス ID が必要です。それを探す方法については、「[Amazon Connect インスタンスの ID または ARN の検索](find-instance-arn.md)」を参照してください。
+ Amazon Connect インスタンスのソースリージョンも知っておく必要があります。それを探す方法については、「[Amazon Connect インスタンスのソースリージョンを確認する方法](create-replica-connect-instance.md#how-to-find-source-region-of-instances)」を参照してください。
+ iframe 内に Connect アプリケーションを埋め込む場合は、グローバルサインインが機能するように、ソースインスタンスとレプリカインスタンスの両方で承認済みオリジンのリストにドメインが含まれていることを確認する必要があります。
インスタンスレベルで承認済みオリジンを設定するには、「[Amazon Connect で統合アプリケーションの許可リストを使用する](app-integration.md)」のステップに従います。
+ エージェントは既にソースとレプリカ Amazon Connect インスタンスの*両方*ので作成されており、ID プロバイダー (IdP) のロールセッション名と同じユーザー名を使用する必要があります。それ以外の場合は、`UserNotOnboardedException` 例外と、インスタンス間のエージェント冗長機能が失われるリスクがあります。
+ エージェントがサインインを試みる前に、エージェントをトラフィック分散グループに関連付ける必要があります。そうしないと、エージェントのサインインが失敗し、`ResourceNotFoundException` が表示されます。トラフィック分散グループを設定し、それらにエージェントを関連付ける方法については、「[複数の AWS リージョンにまたがる Amazon Connect インスタンスにエージェントを関連付ける](associate-agents-across-regions.md)」を参照してください。
+ エージェントが新しい SAML サインイン URL で Amazon Connect にフェデレーションされると、Amazon Connect Global Resiliency は、トラフィック分散グループで `SignInConfig` がどのような設定になっているかにかかわらず、常にエージェントをソースとレプリカの両方のリージョン/インスタンスにログインさせようとします。CloudTrail のログをチェックすることでこれを確認できます。
+ デフォルトのトラフィック`SignInConfig`分散グループの分散は AWS リージョン 、サインインを容易にするために使用される のみを決定します。`SignInConfig` 分散がどのように設定されているかにかかわらず、Amazon Connect は常に Amazon Connect インスタンスの両方のリージョンにエージェントをサインインさせようとします。
+ Amazon Connect インスタンスを複製すると、インスタンス用に SAML サインインエンドポイントが 1 つだけ生成されます。このエンドポイントには、常に URL AWS リージョン にソースが含まれます。
+ Amazon Connect Global Resiliency でパーソナライズされた SAML サインイン URL を使用する場合、リレーステートを設定する必要はありません。
## ID プロバイダーの統合方法
1. [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API を使用して Amazon Connect インスタンスのレプリカを作成する場合、Amazon Connect インスタンス用にパーソナライズされた SAML サインイン URL が生成されます。URL は次の形式で生成されます。
`https://instance-id.source-region.sign-in.connect.aws/saml`
1. *instance-id* は、インスタンスグループ内のいずれかのインスタンスのインスタンス ID です。インスタンス ID はソースリージョンとレプリカリージョンで同一です。
1. *source-region* は、[ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API が呼び出されたソース AWS リージョンに対応します。
1. IAM フェデレーションロールに次の信頼ポリシーを追加します。次の例のように、グローバルサインイン SAML エンドポイントの URL を使用します。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Principal":{
"Federated":[
"arn:aws:iam::111122223333:saml-provider/MySAMLProvider"
]
},
"Action":"sts:AssumeRoleWithSAML",
"Condition":{
"StringLike":{
"SAML:aud":[
"https://instance-id.source-region.sign-in.connect.aws/saml*"
]
}
}
}
]
}
```
------
**注記**
`saml-provider-arn` は、IAM で作成された ID プロバイダーリソースです。
1. IAM フェデレーションロールの `InstanceId` 向けに、`connect:GetFederationToken` にアクセス権を付与します。例えば、次のようになります。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "GetFederationTokenAccess",
"Effect": "Allow",
"Action": "connect:GetFederationToken",
"Resource": "*",
"Condition": {
"StringEquals": {
"connect:InstanceId": "your-instance-id"
}
}
}
]
}
```
------
1. 以下の属性と値の文字列を使用して、ID プロバイダーアプリケーションに属性マッピングを追加します。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/integrate-idp.html)
1. ID プロバイダーの Assertion Consumer Service (ACS) URL を、パーソナライズされた SAML サインイン URL を指すように設定します。ACS URL の次の例を使用します。
```
https://instance-id.source-region.sign-in.connect.aws/saml?&instanceId=instance-id&accountId=your AWS account ID&role=saml-federation-role&idp=your SAML IDP&destination=optional-destination
```
1. URL パラメータに次のフィールドを設定します。
+ `instanceId`: Amazon Connect インスタンスの識別子。インスタンス ID を見つける方法については、「[Amazon Connect インスタンスの ID または ARN の検索](find-instance-arn.md)」を参照してください。
+ `accountId`: Amazon Connect インスタンスが配置されている AWS アカウント ID。
+ `role`: Amazon Connect フェデレーションに使用される SAML ロールの名前または Amazon リソースネーム (ARN) に設定します。
+ `idp`: IAM の SAML ID プロバイダーの名前または Amazon リソースネーム (ARN)に設定します。
+ `destination`: エージェントがサインイン後にインスタンスにアクセスするオプションのパスに設定します (例:`/agent-app-v2`)。
# 複数の AWS リージョンにまたがる Amazon Connect インスタンスにエージェントを関連付ける
エージェントが両方の にサインイン AWS リージョン し、どちらのリージョンからの問い合わせも処理できるようにするには、まずトラフィック分散グループに割り当てる必要があります。
1. トラフィック分散グループをまだ設定していない場合は、ここで設定してください。手順については、「[Amazon Connect インスタンスのトラフィック分散グループを作成する](setup-traffic-distribution-groups.md)」を参照してください。
1. トラフィック分散グループが正常に作成されたら (`Status` は `ACTIVE`)、エージェントを割り当てることができます。ユーザーは常にソースリージョンのトラフィック分散グループに関連付けてください。
`ACTIVE` ステータスを `ResourceNotFoundException` にしなくても、エージェントをトラフィック分散グループに割り当てます。[DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API を使用して、トラフィック分散グループが正常に作成された (`Status` が `ACTIVE`) かどうかを判断します。
1. [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html) API を呼び出すことにより、エージェントをトラフィック分散グループに割り当てることができます。
## 例
次のコマンド`associate-traffic-distribution-group-user`例は、複数の AWS リージョンでエージェントを関連付けて使用する方法を示しています。
```
aws connect associate-traffic-distribution-group-user
--traffic-distribution-group-id UUID
--user-id UUID
--instance-id
```
次の [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html) の例では、エージェントをトラフィック分散グループに関連付けています。
```
PUT /traffic-distribution-group/trafficDistributionGroupId/user HTTP/1.1
Content-type: application/json
{
"UserId": "string"
}
```
次の `disassociate-traffic-distribution-group-user` コマンド例では、エージェントをトラフィック分散グループから解除しています。
```
aws connect disassociate-traffic-distribution-group-user
--instance-id your instance ID
--traffic-distribution-group-id UUID
--user-id UUID
```
次の [DisassociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_DisassociateTrafficDistributionGroupUser.html) の例では、エージェントをトラフィック分散グループから解除しています。
```
DELETE /traffic-distribution-group/trafficDistributionGroupId/user/UserId HTTP/1.1
```
## AssociateTrafficDistributionGroupUser コールが失敗する理由
[AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html) API コールは、次のような場合に失敗し、`ResourceNotFoundException` が表示されます。
1. 指定されたトラフィック分散グループが存在しません。
1. トラフィック分散グループのステータスは `ACTIVE` です。
1. `user-id UUID` は Amazon Connect ソースインスタンスのユーザーではありません。
# AWS リージョン間で Amazon Connect エージェントワークスペースのエージェントディストリビューションを更新する
`UpdateTrafficDistribution` API を、[テレフォニートラフィックをリージョン間で分散](update-telephony-traffic-distribution.md)するのに使用できるように、 AWS リージョン全体に分散させるのににも使えます。これは、通常の定期的な運用準備テストの一環として完全に、または段階的に実施します。たとえば、1 つの 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 状態を閉じると、エージェントは自動的に新しいリージョンに更新されます。アクションは必要ありません。エージェントがコンタクトを閉じられない場合は、**バックアップで続行**を選択すると、別のリージョンに切り替えるための確認を求めるポップアップが表示されます。
これを反映するようにランブックとエージェントトレーニングガイドを調整することをお勧めします。
![\[TDG 調整中のリージョンフェイルオーバーを強調表示するバナーを示す エージェントワークスペース UI。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/acgr-failover-banner.png)
![\[エージェントがバックアップで続行を選択したときに表示される確認ポップアップ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/acgr-failover-confirmation.png)
# AWS リージョン間でのエージェントのシフトをサポートするように Amazon Connect エージェントワークスペースを設定する
次の手順を実行して、Amazon Connect Agent WorkSpace が問い合わせコントロールパネルをレプリカ AWS リージョンからレプリケート元リージョンに埋め込み、エージェントのアクティブなリージョンが変更されるとそれら間で移行できるようにします。
ソース Amazon Connect インスタンスのレプリカをまだ作成していない場合や、トラフィック分散グループを設定していない場合は、「[Amazon Connect グローバルレジリエンシーの使用開始](get-started-connect-global-resiliency.md)」を参照してください。
1. AWS Amazon Connect コンソールに移動して、ソースインスタンスの**アクセス URL** を取得します。URL を記録します。
1. レプリカリージョンで、 AWS Amazon Connect コンソールを使用してレプリカインスタンスの**アクセス URL** を取得します。URL を記録します。
1. レプリカ Amazon Connect インスタンスと同じウィンドウの左側のペインで、**[承認済みオリジン]** を選択します。
1. ソースインスタンス**アクセス URL** にドメインを追加します。これは、ステップ 1 で書き留めたものです。
**注記**
末尾の **/** は、アクセス URL に含めないでください。
1. ソースインスタンスで上記の手順を繰り返します。**[承認済みオリジン]** に移動し、レプリカインスタンスのアクセス URL を追加します。
**注記**
エージェントは、リージョン間で移動した後に、ステータスを **[利用可能]** に設定する必要があります。
# Amazon Connect インスタンスのエージェントをリージョン間で シフトする際の問題を回避するためのヒント
+ エージェントのトラフィック分散を更新するときは必ず、インバウンドの音声問い合わせのトラフィック分散も更新してください。そうしないと、一方のリージョンではエージェントが多く、もう一方のリージョンではテレフォニートラフィックが多いという状況に陥る可能性があります。
+ ユーザーをトラフィック分散グループに関連付ける前に、ソースとレプリカの両方の Amazon Connect インスタンスに同じユーザー名が存在することを確認します。そうしないと、ユーザーをトラフィック分散グループに関連付けても、そのユーザー名のユーザーがレプリカリージョンに存在しない場合は、`InvalidRequestException` エラーが発生します。
+ ソースリージョンのトラフィック分散グループにエージェントを関連付けるには、[AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html) API を呼び出す必要があります。レプリカのリージョンにいるときにこれを行おうとすると、`ResourceNotFoundException` エラーが発生します。