기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# MediaTailor에서 재생 문제 해결
이 단원에서는 플레이어 소프트웨어를 테스트하거나 플레이어 요청을 정상적으로 처리하는 동안 수신할 수 있는 HTTP 오류 코드에 대한 정보를 제공합니다.
**참고**
`PutPlaybackConfiguration` 및와 같은 구성 작업 중에 AWS Elemental MediaTailor API에서 오류가 발생할 수도 있습니다`GetPlaybackConfiguration`. 이러한 유형의 오류에 대한 자세한 내용은 [AWS Elemental MediaTailor API](https://docs.aws.amazon.com/mediatailor/latest/apireference/Welcome.html) 참조를 참조하세요.
플레이어가 AWS Elemental MediaTailor직접 또는 CDN을 통해에 요청을 보내면 MediaTailor는 상태 코드로 응답합니다. MediaTailor가 요청을 성공적으로 처리하면 HTTP 상태 코드를 반환하여 채워진 매니페스트와 함께 성공을 `200 OK`나타냅니다. 요청이 실패하면 MediaTailor는 HTTP 상태 코드, 예외 이름 및 오류 메시지를 반환합니다.
AWS Elemental MediaTailor 는 두 가지 오류 클래스를 반환합니다.
+ **클라이언트 오류** - 일반적으로 잘못된 형식의 요청, 잘못된 파라미터 또는 잘못된 URL과 같은 요청 자체의 문제로 인해 발생하는 오류입니다. 이러한 오류는 HTTP `4xx` 응답 코드를 지닙니다.
+ **서버 오류** - 일반적으로 MediaTailor 또는 광고 결정 서버(ADS) 또는 오리진 서버와 같은 종속성 중 하나에 문제가 발생하여 발생하는 오류입니다. 이러한 오류는 HTTP `5xx` 응답 코드를 지닙니다.
**Topics**
+ [에서 반환한 클라이언트 재생 오류 AWS Elemental MediaTailor](#playback-errors-client)
+ [에서 반환한 서버 재생 오류 AWS Elemental MediaTailor](#playback-errors-server)
+ [재생 오류 예제](#playback-errors-examples)
## 에서 반환한 클라이언트 재생 오류 AWS Elemental MediaTailor
일반 지침:
+ 응답의 머리말과 본문에서 대부분의 오류에 대한 자세한 정보를 확인할 수 있습니다.
+ 일부 오류의 경우, 구성 설정을 확인해야 합니다. 재생 구성에 대한 설정을 검색할 수 있습니다 AWS Elemental MediaTailor. API의 경우, 리소스는 `GetPlaybackConfiguration/Name`입니다. 자세한 내용은 [AWS Elemental MediaTailor API 참조](https://docs.aws.amazon.com/mediatailor/latest/apireference/)를 참조하세요.
다음 표에는의 매니페스트 조작 활동에서 반환되는 클라이언트 오류 코드 AWS Elemental MediaTailor, 가능한 원인 및 이를 해결하기 위해 취할 수 있는 작업이 나열되어 있습니다.
| 코드 | 예외 이름 | 의미 | 수행할 작업 |
| --- | --- | --- | --- |
| 400 | BadRequestException | 형식 또는 콘텐츠에 하나 이상의 오류가 발생하여 MediaTailor에서 요청을 처리할 수 없습니다. 파라미터의 형식이 부적절하게 지정되었거나 요청에 잘못된 재생 구성 또는 세션 ID가 포함되어 있을 수 있습니다. | 요청의 형식이 적절히 지정되고 정확한 정보를 포함하는 지 확인합니다. 플레이어의 재생 엔드포인트 설정이 GetPlaybackConfiguration이 반환하는.ManifestEndpointPrefix 설정과 일치하는지 확인합니다. 요청을 재시도합니다. |
| 403 | AccessDeniedException | 요청에 제공된 호스트 헤더가 MediaTailor 재생 URL에 구성된 매니페스트 엔드포인트 접두사와 일치하지 않습니다. CDN이 잘못 구성되었을 수 있습니다. | CDN 설정을 확인하고 MediaTailor에 올바른 매니페스트 엔드포인트 접두사를 사용하고 있는지 확인합니다. 요청을 재시도합니다. |
| 404 | NotFoundException | MediaTailor가 지정된 정보를 찾을 수 없습니다. 서비스 내의 어떤 항목에도 매핑되지 않은 URL, 정의되지 않은 ㄷ구성 또는 사용할 수 없는 세션이 원인일 수 있습니다. | 구성 및 요청의 타당성을 확인한 다음 세션을 재초기화합니다. |
| 409 | ConflictException | 플레이어에서 한 세션에 대하여 여러 개의 재생 목록을 동시에 로드하려고 시도했습니다. 따라서 MediaTailor가 세션 일관성 충돌을 감지했습니다. 이 문제는 HLS 플레이어의 경우 발생합니다. | 플레이어에서 재생 목록을 한 번에 하나씩 요청하는지 확인하십시오. 이는 HLS 사양에 따른 것입니다. |
| 410 | Gone | AWS 지원 운영자가 플레이어 세션 또는 고객 구성을 차단했습니다. 드물지만 단일 세션 또는 구성에 대한 잘못된 트래픽에서 발생하는 매우 많은 양의 4xx 요청이 감지되는 경우 AWS Support가 이를 수행합니다. | 요청을 차단해서는 안 된다고 생각되면 [AWS Support](https://aws.amazon.com/premiumsupport/)에 문의하십시오. 지원팀에서 상황을 확인하고 해당하는 경우 차단 필터를 제거할 수 있습니다. |
추가 지원이 필요한 경우 [AWS Support](https://aws.amazon.com/premiumsupport/)에 문의하십시오.
## 에서 반환한 서버 재생 오류 AWS Elemental MediaTailor
일반 지침:
+ 응답의 머리말과 본문에서 대부분의 오류에 대한 자세한 정보를 확인할 수 있습니다.
+ 일부 오류의 경우, 구성 설정을 확인해야 합니다. 재생 구성에 대한 설정을 검색할 수 있습니다 AWS Elemental MediaTailor. API의 경우, 리소스는 `GetPlaybackConfiguration/Name`입니다. 자세한 내용은 [AWS Elemental MediaTailor API 참조](https://docs.aws.amazon.com/mediatailor/latest/apireference/)를 참조하세요.
다음 표에는의 매니페스트 조작 활동에서 반환된 서버 오류 코드 AWS Elemental MediaTailor, 가능한 원인 및 이를 해결하기 위해 취할 수 있는 작업이 나열되어 있습니다.
| 코드 | 예외 이름 | 의미 | 수행할 작업 |
| --- | --- | --- | --- |
| 500 | InternalServiceError | 처리되지 않은 예외입니다. | 요청을 다시 시도하세요. 문제가 지속되면에서 해당 AWS 리전에 대해 MediaTailor의 보고된 상태를 확인합니다[https://status.aws.amazon.com/](https://status.aws.amazon.com/). |
| 502 | BadGatewayException | 오리진 서버 주소 또는 광고 결정 서버(ADS) 주소가 잘못되었습니다. 잘못된 주소의 예로 프라이빗 IP 주소와 localhost를 들 수 있습니다. | 구성에 ADS 및 오리진 서버에 대한 올바른 설정이 있는지 확인한 다음 요청을 재시도합니다. |
| 502 | UnsupportedManifestException | MediaTailor가 개인화할 수 없도록 오리진 매니페스트가 변경되었거나 MediaTailor가 오리진의 매니페스트 형식을 지원하지 않습니다. | 이런 상황은 개별 세션에만 영향을 미칠 수 있습니다. 세션을 재초기화합니다. 일반적으로 뷰어에서 페이지를 새로 고쳐 그렇게 할 수 있습니다. 문제가 지속되면 MediaTailor가 오리진의 매니페스트 형식을 지원하는지 확인합니다. 자세한 내용은 [콘텐츠 소스 통합](integrating-origin.md) 단원을 참조하세요. |
| 503 | LoadShed | MediaTailor에서 요청을 처리하는 동안 리소스 제약이 발생했습니다. | 요청을 다시 시도하세요. 문제가 지속되면에서 해당 AWS 리전에 대해 MediaTailor의 보고된 상태를 확인합니다[https://status.aws.amazon.com/](https://status.aws.amazon.com/). |
| 503 | ThrottlingException | 초당 트랜잭션이 할당량에 도달했으며 MediaTailor에서 사용을 제한하고 있습니다. | 요청을 다시 시도하세요. 에서 해당 AWS 리전에 대해 보고된 MediaTailor 상태를 확인할 수도 있습니다[https://status.aws.amazon.com/](https://status.aws.amazon.com/). 초당 트랜잭션 할당량을 늘려야 할 수 있습니다. 자세한 내용은 [광고 삽입에 대한 할당량](quotas.md#ad-insertion-quotas) 단원을 참조하십시오. |
| 504 | GatewayTimeoutException | MediaTailor가 오리진 서버에 연결하는 동안 제한 시간이 발생했습니다. | 요청을 다시 시도하세요. 문제가 지속되는 경우 오리진 서버의 상태를 확인하고 오리진 서버가 [광고 삽입에 대한 할당량](quotas.md#ad-insertion-quotas)에 나열된 콘텐츠 오리진 서버 시간 제한 내에 응답하고 있는지 확인합니다. |
추가 지원이 필요한 경우 [AWS Support](https://aws.amazon.com/premiumsupport/)에 문의하십시오.
## 재생 오류 예제
이 섹션에서는 명령줄 상호 작용에서 볼 수 있는 재생 오류의 몇 가지 예를 나열합니다 AWS Elemental MediaTailor.
다음 예제는 AWS Elemental MediaTailor 와 광고 결정 서버(ADS) 또는 오리진 서버 간에 제한 시간이 발생할 때의 결과를 보여줍니다.
```
~[]> curl -vvv https://111122223333444455556666123456789012.mediatailor.us-west-2.amazonaws.com/v1/master/123456789012/Multiperiod_DASH_Demo/index.mpd
* Trying 54.186.133.224...
* Connected to 111122223333444455556666123456789012.mediatailor.us-west-2.amazonaws.com (11.222.333.444) port 555 (#0)
* TLS 1.2 connection using TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
* Server certificate: mediatailor.us-west-2.amazonaws.com
* Server certificate: Amazon
* Server certificate: Amazon Root CA 1
* Server certificate: Starfield Services Root Certificate Authority - G2
> GET /v1/master/123456789012/Multiperiod_DASH_Demo/index.mpd HTTP/1.1
> Host: 111122223333444455556666123456789012.mediatailor.us-west-2.amazonaws.com
> User-Agent: curl/7.43.0
> Accept: */*
>
< HTTP/1.1 504 Gateway Timeout
< Date: Thu, 29 Nov 2018 18:43:14 GMT
< Content-Type: application/json
< Content-Length: 338
< Connection: keep-alive
< x-amzn-RequestId: 123456789012-123456789012
< x-amzn-ErrorType: GatewayTimeoutException:http://internal.amazon.com/coral/com.amazon.elemental.midas.mms.coral/
<
* Connection #0 to host 111122223333444455556666123456789012.mediatailor.us-west-2.amazonaws.com left intact
{"message":"failed to generate manifest: Unable to obtain template playlist. origin URL:[https://777788889999.mediapackage.us-west-2.amazonaws.com/out/v1/444455556666111122223333/index.mpd], asset path: [index.mpd], sessionId:[123456789012123456789012] customerId:[123456789012]"}%
```