**지원 종료 공지:** 2026년 10월 30일에 Amazon Pinpoint에 대한 지원이 AWS 종료됩니다. 2026년 10월 30일 이후에는 Amazon Pinpoint 콘솔 또는 Amazon Pinpoint 리소스(엔드포인트, 세그먼트, 캠페인, 여정, 분석)에 더 이상 액세스할 수 없습니다. 자세한 내용은 [Amazon Pinpoint 지원 종료](https://docs.aws.amazon.com/console/pinpoint/migration-guide)를 참조하세요. **참고:** SMS, 음성, 모바일 푸시, OTP 및 전화번호 검증과 관련된 APIs는이 변경의 영향을 받지 않으며 AWS 최종 사용자 메시징에서 지원됩니다.

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

# 세그먼트 문제 해결
<a name="segments-troubleshooting"></a>

실패 원인을 식별하는 데 도움이 되도록 로깅이 켜져 있는지 확인하세요. 자세한 내용은 [모니터링 및 로깅](troubleshooting.md#troubleshooting-logging)을 참조하세요.

## 세그먼트 가져오기 실패
<a name="troubleshooting-segment-import"></a>

세그먼트 가져오기에 실패하면 다음 오류 메시지 또는 이와 유사한 오류 메시지가 표시될 수 있습니다.

**가져오기 작업**: 세그먼트 이름이 SampleTemplate인 SampleTemplate.csv 파일 가져오기가 실패했습니다. 잘못된 요청: 수신한 데이터가 CreateImportJob 작업에 필요한 형식과 일치하지 않습니다. 요청의 정보가 올바른 형식인지 확인한 후 다시 요청을 제출하세요.

****문제 및 해결 방법****
+ 이 오류는 가져온 템플릿의 형식이 올바르지 않을 때 발생합니다.
+ 템플릿이 유효한 JSON 또는 CSV 형식인지 확인하세요. 올바른 형식의 예는 [세그먼트 파일](segments-importing.md#segments-importing-examples-files) 섹션을 참조하세요. 콘솔에서 샘플 템플릿을 다운로드할 수도 있습니다. 프로젝트에서 **세그먼트**, **세그먼트 생성**, **세그먼트 가져오기**를 선택하고, **예제 CSV 다운로드**를 선택합니다.
+ 지정된 모든 속성이 유효한지 확인합니다. 세그먼트를 가져올 때 **ChannelType**과 **address**는 필수 필드입니다. 속성 이름은 대소문자를 구분합니다. 템플릿에 추가할 수 있는 속성의 전체 목록은 [지원되는 속성](segments-importing.md#segments-importing-available-attributes) 섹션을 참조하세요.

## 세그먼트 내보내기 실패
<a name="troubleshooting-segment-export"></a>

****문제 및 해결 방법****
+ 콘솔에서 이 작업을 수행할 때 대규모 내보내기 작업이 실패할 수 있습니다.
+ 이 제한을 해결하기 위해 Command Line Interface(CLI) 또는 SDK를 통해 [CreateExportJob](https://docs.aws.amazon.com//pinpoint/latest/apireference/apps-application-id-jobs-export.html#apps-application-id-jobs-exportpost) API를 사용하여 세그먼트를 Amazon S3 버킷으로 내보낼 수 있습니다.

## 동적 세그먼트의 엔드포인트 수
<a name="troubleshooting-dynamic-segment"></a>

****문제 및 해결 방법****
+ 캠페인을 생성할 때 동적 세그먼트를 사용하는 경우 엔드포인트 수는 근사치이며 정확하지 않을 수 있습니다. 이는 동적 세그먼트의 엔드포인트 데이터가 정의된 기준에 따라 시간이 지남에 따라 변경될 수 있기 때문입니다. 세그먼트를 내보내 지정된 시점의 정확한 엔드포인트 수를 확인할 수 있습니다.

## BadRequestException: 사용자 수당 최대 엔드포인트 초과: 15
<a name="troubleshooting-badrequestexception"></a>

이 오류는 동일한 `UserId`에 연결된 엔드포인트를 15개 이상 추가하려고 할 때 발생합니다.

**참고**  
새 엔드포인트의 채널 유형이 ADM, GCM, APNS, APNS\$1VOICE, APNS\$1VOIP\$1SANDBOX 또는 BAIDU인 경우 이러한 채널 유형 중 하나가 있는 엔드포인트가 이미 있다면 요청이 성공합니다. 자세한 내용은 *Amazon Pinpoint 개발자 안내서*의 [Managing an audience members maximum number of endpoints](https://docs.aws.amazon.com/pinpoint/latest/developerguide/audience-define-auto-inactive.html)를 참조하세요.

****문제 및 해결 방법****
+ [update-endpoint](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/update-endpoint.html) API를 사용하여 새 엔드포인트를 생성하거나 기존 엔드포인트를 편집할 때 특정 엔드포인트가 최대 15개의 엔드포인트 주소를 초과하면 이 오류가 발생할 수 있습니다.
+ 이 제한은 현재 해당 서비스의 하드 제한입니다. 늘릴 수는 없습니다. 자세한 내용은 [엔드포인트 할당량](https://docs.aws.amazon.com//pinpoint/latest/developerguide/quotas.html#quotas-endpoint)을 참조하세요.

## UpdateEndpointsBatch 또는 UpdateEndPoints 작업 호출 시 BadRequestException: 사용자 지정 속성이 너무 많음
<a name="troubleshooting-attributes"></a>

이 오류는 250개가 넘는 속성을 추가하려고 할 때 발생합니다. 사용자 지정 속성의 최대 크기는 엔드포인트당 15KB입니다.

****문제 및 해결 방법****
+ 세그먼트를 내보내고 검사하여 사용자 지정 속성의 수를 확인합니다.
+ 예외를 해결하려면 [How do I resolve a "too many attributes" error in Amazon Pinpoint?](https://repost.aws/knowledge-center/pinpoint-additional-attributes)를 참조하세요.