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