기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Connect Customer의 트래픽 분산 그룹에 클레임된 전화번호 할당
<a name="assign-phone-numbers-traffic-distribution-groups"></a>
+ 새 트래픽 분산 그룹을 만들었고 상태는 `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을 입력합니다.

**참고**  
**설명** 필드를 업데이트하려면 Connect Customer 콘솔을 사용해야 합니다.

## 워크플로 예제
<a name="example-workflow-assign"></a>

다음은 트래픽 분산 그룹에 요청된 전화번호를 할당하는 워크플로 예시입니다.

1. [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API를 호출하여 새 `TargetArn`에 전화번호를 할당합니다.

   는 다른 Connect Customer 인스턴스 또는 전화번호가 처음 신청된 동일한 리전에서 생성된 트래픽 분산 그룹에 대한 것일 `TargetArn` 수 있습니다.

1. 다음 단계를 수행하여 흐름을 전화번호에 연결합니다.

   이러한 단계를 통해 텔레포니 트래픽이 흐름으로 올바르게 라우팅되어 트래픽 분산 구성을 지원할 수 있습니다.

   1. 트래픽 분산 그룹이 생성된 리전의 기존 Connect Customer 인스턴스에서 다음 단계를 수행합니다.

     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 여러 리전의 Connect Customer 인스턴스 간에 미러링됩니다.

## AssociatePhoneNumberContactFlow 호출이 실패하는 이유
<a name="why-associatephonenumbercontactflow-fails"></a>

번호가 트래픽 분산 그룹에 클레임되고 트래픽 분산 그룹이 생성된의 인스턴스를 사용하여 [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)를 호출 AWS 리전 하는 경우 `PhoneNumberId` URI 요청 파라미터에 전체 전화번호 ARN 또는 UUID 값을 사용할 수 있습니다.

그러나 번호가 트래픽 분산 그룹에 클레임되고 트래픽 분산 그룹과 AWS 리전 연결된 복제본의 인스턴스를 사용하여이 API를 호출하는 경우 전체 전화번호 ARN을 제공해야 합니다. 이 시나리오에서 UUID를 제공하면 `ResourceNotFoundException`이 발생합니다.

## UpdatePhoneNumber 호출이 실패하는 이유
<a name="why-updatephonenumber-fails"></a>

다음과 같은 경우 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API 호출이 `ResourceNotFoundException`과 함께 실패합니다.
+ 지정한 트래픽 분산 그룹이 존재하지 않거나, 트래픽 분산 그룹의 상태가 `ACTIVE` 상태가 아니거나, 트래픽 분산 그룹의 소유권이 없는 경우입니다.

다음과 같은 경우 `InvalidParameterException` 오류와 함께 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)가 실패합니다
+ 호출 중인 엔드포인트가 트래픽 분산 그룹이 생성된 리전과 동일한 리전에 있지 않습니다.

## 전화번호 상태 정의
<a name="update-phone-number-status"></a>

다음은 전화번호 상태에 대한 설명입니다.
+ `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` 값이 총 클레임된 건수 한도에 도달한 것이 실패의 일반적인 원인입니다.