기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
이 단원에서는 플레이어 소프트웨어를 테스트하거나 플레이어 요청을 정상적으로 처리하는 동안 수신할 수 있는 HTTP 오류 코드에 대한 정보를 제공합니다.
참고
PutPlaybackConfiguration 및와 같은 구성 작업 중에 AWS Elemental MediaTailor API에서 오류가 발생할 수도 있습니다GetPlaybackConfiguration. 이러한 유형의 오류에 대한 자세한 내용은 AWS Elemental MediaTailor API 참조를 참조하세요.
플레이어가 AWS Elemental MediaTailor직접 또는 CDN을 통해에 요청을 보내면 MediaTailor는 상태 코드로 응답합니다. MediaTailor가 요청을 성공적으로 처리하면 HTTP 상태 코드를 반환하여 채워진 매니페스트와 함께 성공을 200 OK나타냅니다. 요청이 실패하면 MediaTailor는 HTTP 상태 코드, 예외 이름 및 오류 메시지를 반환합니다.
AWS Elemental MediaTailor 는 두 가지 오류 클래스를 반환합니다.
-
클라이언트 오류 - 일반적으로 잘못된 형식의 요청, 잘못된 파라미터 또는 잘못된 URL과 같은 요청 자체의 문제로 인해 발생하는 오류입니다. 이러한 오류는 HTTP
4xx응답 코드를 지닙니다. -
서버 오류 - 일반적으로 MediaTailor 또는 광고 결정 서버(ADS) 또는 오리진 서버와 같은 해당 종속성 중 하나와 관련된 문제로 인해 발생하는 오류입니다. 이러한 오류는 HTTP
5xx응답 코드를 지닙니다.
에서 반환한 클라이언트 재생 오류 AWS Elemental MediaTailor
일반 지침:
응답의 머리말과 본문에서 대부분의 오류에 대한 자세한 정보를 확인할 수 있습니다.
일부 오류의 경우, 구성 설정을 확인해야 합니다. 재생 구성에 대한 설정을 검색할 수 있습니다 AWS Elemental MediaTailor. API의 경우, 리소스는
GetPlaybackConfiguration/입니다. 자세한 내용은 AWS Elemental MediaTailor API 참조를 참조하세요.Name
다음 표에는의 매니페스트 조작 활동에서 반환되는 클라이언트 오류 코드 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 지원 운영자가 이를 수행합니다. | 요청을 차단해서는 안 된다고 생각되면 AWS Support |
추가 지원이 필요한 경우 AWS Support
에서 반환한 서버 재생 오류 AWS Elemental MediaTailor
일반 지침:
응답의 머리말과 본문에서 대부분의 오류에 대한 자세한 정보를 확인할 수 있습니다.
일부 오류의 경우, 구성 설정을 확인해야 합니다. 재생 구성에 대한 설정을 검색할 수 있습니다 AWS Elemental MediaTailor. API의 경우, 리소스는
GetPlaybackConfiguration/입니다. 자세한 내용은 AWS Elemental MediaTailor API 참조를 참조하세요.Name
다음 표에는의 매니페스트 조작 활동에서 반환되는 서버 오류 코드 AWS Elemental MediaTailor, 가능한 원인 및 이를 해결하기 위해 취할 수 있는 작업이 나열되어 있습니다.
| 코드 | 예외 이름 | 의미 | 수행할 작업 |
|---|---|---|---|
| 500 | InternalServiceError |
처리되지 않은 예외입니다. | 요청을 다시 시도하세요. 문제가 지속되면에서 해당 AWS 리전에 대해 MediaTailor의 보고된 상태를 확인합니다https://status.aws.amazon.com/ |
| 502 | BadGatewayException |
오리진 서버 주소 또는 광고 결정 서버(ADS) 주소가 잘못되었습니다. 잘못된 주소의 예로 프라이빗 IP 주소와 localhost를 들 수 있습니다. |
구성에 ADS 및 오리진 서버에 대한 올바른 설정이 있는지 확인한 다음 요청을 재시도합니다. |
| 502 | UnsupportedManifestException |
MediaTailor가 개인화할 수 없도록 오리진 매니페스트가 변경되었거나 MediaTailor가 오리진의 매니페스트 형식을 지원하지 않습니다. | 이런 상황은 개별 세션에만 영향을 미칠 수 있습니다. 세션을 재초기화합니다. 일반적으로 뷰어에서 페이지를 새로 고쳐 그렇게 할 수 있습니다. 문제가 지속되면 MediaTailor가 오리진의 매니페스트 형식을 지원하는지 확인합니다. 자세한 내용은 콘텐츠 소스 통합을 참조하세요. |
| 503 | LoadShed |
MediaTailor에서 요청을 처리하는 동안 리소스 제약이 발생했습니다. | 요청을 다시 시도하세요. 문제가 지속되면에서 해당 AWS 리전에 대해 MediaTailor의 보고된 상태를 확인합니다https://status.aws.amazon.com/ |
| 503 | ThrottlingException |
초당 트랜잭션이 할당량에 도달했으며 MediaTailor가 사용을 제한하고 있습니다. | 요청을 다시 시도하세요. 에서 해당 AWS 리전에 대해 MediaTailor의 보고된 상태를 확인할 수도 있습니다https://status.aws.amazon.com/ |
| 504 | GatewayTimeoutException |
MediaTailor가 오리진 서버에 연결하는 동안 제한 시간이 발생했습니다. | 요청을 다시 시도하세요. 문제가 지속되는 경우 오리진 서버의 상태를 확인하고 오리진 서버가 광고 삽입 할당량에 나열된 콘텐츠 오리진 서버 시간 제한 내에 응답하고 있는지 확인합니다. |
추가 지원이 필요한 경우 AWS Support
재생 오류 예제
이 섹션에서는 명령줄 상호 작용에서 볼 수 있는 재생 오류의 몇 가지 예를 나열합니다 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]"}%
