As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Solução de problemas de erros de reprodução retornados por MediaTailor
Esta seção fornece informações sobre os códigos de HTTP erro que você pode receber ao testar o software do player e durante o processamento normal das solicitações do player.
nota
Você também pode receber erros do AWS Elemental MediaTailor API, durante operações de configuração como PutPlaybackConfiguration GetPlaybackConfiguration e. Para obter informações sobre esses tipos de erros, consulte AWS Elemental MediaTailor APIReferência.
Quando seu jogador envia uma solicitação para AWS Elemental MediaTailor, diretamente ou por meio de umCDN, MediaTailor responde com um código de status. Se a solicitação for processada MediaTailor com êxito, ela retornará o código de HTTP status200 OK, indicando sucesso, junto com o manifesto preenchido. Se a solicitação não for bem-sucedida, MediaTailor retornará um código de HTTP status, um nome de exceção e uma mensagem de erro.
AWS Elemental MediaTailor retorna duas classes de erros:
-
Erros do cliente — erros que geralmente são causados por um problema na própria solicitação, como uma solicitação formatada incorretamente, um parâmetro inválido ou incorreto. URL Esses erros têm um código de HTTP
4xxresposta. -
Erros do servidor — erros que geralmente são causados por um problema com MediaTailor ou uma de suas dependências, como o servidor de decisão do anúncio (ADS) ou o servidor de origem. Esses erros têm um código de HTTP
5xxresposta.
Tópicos
Erros de reprodução do cliente retornados por AWS Elemental MediaTailor
Orientação geral:
Você pode encontrar informações detalhadas sobre a maioria dos erros nos cabeçalhos e no corpo da resposta.
Para alguns erros, você precisa verificar suas configurações. Você pode recuperar as configurações da sua configuração de reprodução em AWS Elemental MediaTailor. Para oAPI, o recurso é
GetPlaybackConfiguration/. Para obter detalhes, consulte o AWS Elemental MediaTailor APIReferência.Name
A tabela a seguir lista os códigos de erro do cliente que são retornados pelas atividades de manipulação do manifesto do AWS Elemental MediaTailor, causas prováveis e ações que você pode tomar para resolvê-las.
| Código | Nome de exceção | Significado | O que fazer |
|---|---|---|---|
| 400 | BadRequestException |
MediaTailor não consegue atender à solicitação devido a um ou mais erros na formatação ou no conteúdo. Um parâmetro pode ser formatado incorretamente, ou a solicitação pode conter uma configuração de reprodução ou ID de sessão inválido. | Verifique se a solicitação está formatada corretamente e se contém informações precisas. Verifique se a configuração do endpoint de reprodução no player corresponde à configuração ManifestEndpointPrefix retornada por GetPlaybackConfiguration. Tente sua solicitação novamente. |
| 403 | AccessDeniedException |
O cabeçalho do host fornecido na solicitação não corresponde ao prefixo do endpoint do manifesto configurado na MediaTailor reprodução. URL Seu CDN pode estar configurado incorretamente. | Verifique suas CDN configurações e verifique se você está usando o prefixo correto do endpoint do manifesto para. MediaTailor Tente sua solicitação novamente. |
| 404 | NotFoundException |
MediaTailor não consegue encontrar as informações especificadas. Os possíveis motivos incluem um URL que não está mapeado para nada no serviço, uma configuração que não está definida ou uma sessão que não está disponível. | Verifique a configuração e a validade da sua solicitação e, em seguida, reinicialize a sessão. |
| 409 | ConflictException |
Um player tentou carregar várias listas de reprodução simultaneamente para uma única sessão. Como resultado, MediaTailor detectou um conflito de consistência na sessão. Esse problema ocorre para HLS jogadores. | Verifique se o player solicita listas de reprodução, uma de cada vez. Isso está de acordo com a HLS especificação. |
| 410 | Gone |
Uma AWS O operador de suporte bloqueou a sessão de um jogador ou a configuração do cliente. AWS O Support faz isso em raras circunstâncias, quando detectamos um volume muito alto de solicitações 4xx provenientes de tráfego errôneo para uma única sessão ou configuração. | Se você acha que a solicitação não deve ser bloqueada, entre em contato com o AWSSupport |
Se precisar de mais ajuda, entre em contato com o AWSSupport
Erros de reprodução do servidor retornados por AWS Elemental MediaTailor
Orientação geral:
Você pode encontrar informações detalhadas sobre a maioria dos erros nos cabeçalhos e no corpo da resposta.
Para alguns erros, você precisa verificar suas configurações. Você pode recuperar as configurações da sua configuração de reprodução em AWS Elemental MediaTailor. Para oAPI, o recurso é
GetPlaybackConfiguration/. Para obter detalhes, consulte o AWS Elemental MediaTailor APIReferência.Name
A tabela a seguir lista os códigos de erro do servidor retornados pelas atividades de manipulação do manifesto do AWS Elemental MediaTailor, causas prováveis e ações que você pode tomar para resolvê-las.
| Código | Nome de exceção | Significado | O que fazer |
|---|---|---|---|
| 500 | InternalServiceError |
Exceção não tratada. | Repetir a solicitação . Se o problema persistir, verifique a integridade relatada MediaTailor de seu AWS Região emhttps://status.aws.amazon.com/ |
| 502 | BadGatewayException |
O endereço do servidor de origem ou o endereço do servidor de decisão do anúncio (ADS) são inválidos. Exemplos de endereços inválidos são um endereço IP privado e localhost. |
Certifique-se de que sua configuração tenha as configurações corretas para seu servidor ADS e para o servidor de origem e, em seguida, repita a solicitação. |
| 502 | UnsupportedManifestException |
Ou o manifesto de origem foi alterado para que não seja MediaTailor possível personalizá-lo ou MediaTailor não é compatível com o formato do manifesto de origem. | Isso pode afetar somente a sessão individual. Reinicialize a sessão. Geralmente, você pode fazer isso ao atualizar a página no visualizador. Se o problema persistir, verifique se ele é MediaTailor compatível com o formato de manifesto da origem. Para ter mais informações, consulte Integrando uma fonte de conteúdo. |
| 503 | LoadShed |
MediaTailor enfrentou uma restrição de recursos ao atender sua solicitação. | Repetir a solicitação . Se o problema persistir, verifique a integridade relatada MediaTailor de seu AWS Região emhttps://status.aws.amazon.com/ |
| 503 | ThrottlingException |
Suas transações por segundo atingiram sua cota e MediaTailor estão limitando seu uso. | Repetir a solicitação . Você também pode verificar a saúde relatada MediaTailor de seu AWS Região emhttps://status.aws.amazon.com/ |
| 504 | GatewayTimeoutException |
Ocorreu um tempo limite ao MediaTailor entrar em contato com o servidor de origem. | Repetir a solicitação . Se o problema persistir, verifique a integridade do servidor de origem e se o servidor de origem está respondendo dentro do tempo limite do servidor de origem do conteúdo que está listado em Cotas na inserção de anúncios. |
Se precisar de mais ajuda, entre em contato com o AWSSupport
Exemplos de erros de reprodução
Esta seção lista alguns exemplos dos erros de reprodução que você pode ver nas interações da linha de comando com AWS Elemental MediaTailor.
O exemplo a seguir mostra o resultado quando ocorre um tempo limite entre AWS Elemental MediaTailor e o servidor de decisão do anúncio (ADS) ou o servidor de origem.
~[]> 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]"}%
