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

# 複数の AWS リージョンにまたがる Amazon Connect インスタンスにエージェントを関連付ける
<a name="associate-agents-across-regions"></a>

エージェントが両方の にサインイン 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 を呼び出すことにより、エージェントをトラフィック分散グループに割り当てることができます。

## 例
<a name="examples-associate"></a>

次のコマンド`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 コールが失敗する理由
<a name="why-association-fails"></a>

[AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html) API コールは、次のような場合に失敗し、`ResourceNotFoundException` が表示されます。

1. 指定されたトラフィック分散グループが存在しません。

1. トラフィック分散グループのステータスは `ACTIVE` です。

1. `user-id {{UUID}}` は Amazon Connect ソースインスタンスのユーザーではありません。