Solución de problemas de reproducción devueltos por MediaTailor

En esta sección se proporciona información acerca de los códigos de error HTTP que podría recibir mientras prueba el software de reproducción y durante el procesamiento normal de las solicitudes del reproductor.

nota

También puede recibir errores de la API de AWS Elemental MediaTailor durante las operaciones de configuración como PutPlaybackConfiguration y GetPlaybackConfiguration. Para obtener información sobre estos tipos de errores, consulta la referencia de la AWS Elemental MediaTailor API.

Cuando el reproductor envía una solicitud aAWS Elemental MediaTailor, ya sea directamente o a través de una CDN, MediaTailor responde con un código de estado. Si gestiona la solicitud MediaTailor correctamente, devuelve el código 200 OK de estado HTTP, que indica que la solicitud se ha realizado correctamente, junto con el manifiesto rellenado. Si la solicitud no se realiza correctamente, MediaTailor devuelve un código de estado HTTP, un nombre de excepción y un mensaje de error.

AWS Elemental MediaTailor devuelve dos clases de errores:

• Errores del cliente: errores que suelen deberse a un problema en la propia solicitud, como una solicitud con un formato incorrecto, un parámetro no válido o una URL incorrecta. Estos errores tienen un código de respuesta HTTP 4xx.

• Errores del servidor: errores que suelen deberse a un problema MediaTailor o a una de sus dependencias, como el servidor de decisiones publicitarias (ADS) o el servidor de origen. Estos errores tienen un código de respuesta HTTP 5xx.

Errores de reproducción del cliente devueltos por AWS Elemental MediaTailor

Guía general:

• Puedes encontrar información detallada sobre la mayoría de los errores en los encabezados y el cuerpo de la respuesta.

• En el caso de algunos errores, debes comprobar los ajustes de configuración. Puede recuperar los ajustes de su configuración de reproducción desdeAWS Elemental MediaTailor. Para la API, el recurso esGetPlaybackConfiguration/Name. Para obtener más información, consulta la referencia AWS Elemental MediaTailor de la API.

En la siguiente tabla se enumeran los códigos de error de cliente que devuelven las actividades de manipulación de manifiestos de AWS Elemental MediaTailor, las causas probables del error y las medidas que puede tomar para resolverlos.

Code	Nombre de la excepción	Significado	Solución
400	BadRequestException	MediaTailor no puede atender la solicitud debido a uno o más errores de formato o contenido. Puede ser que un parámetro no tenga el formato adecuado o que la solicitud incluya un ID de sesión o una configuración de reproducción no válidos.	Compruebe que su solicitud tenga el formato correcto y que incluya la información exacta. Asegúrese de que el ajuste de punto de enlace de reproducción en el reproductor coincida con la configuración ManifestEndpointPrefix que devuelve GetPlaybackConfiguration. Vuelva a enviar la solicitud.
403	AccessDeniedException	El encabezado del host proporcionado en la solicitud no coincide con el prefijo del punto de enlace del manifiesto configurado en la URL de reproducción de MediaTailor. Puede que su CDN no esté bien configurada.	Compruebe la configuración de la CDN y asegúrese de que está usando el prefijo del punto de enlace del manifiesto correcto para MediaTailor. Vuelva a enviar la solicitud.
404	NotFoundException	MediaTailor no encuentra la información especificada. Las razones posibles son que una URL no esté mapeada con nada en el servicio, que no se haya definido una configuración o que una sesión no esté disponible.	Compruebe la configuración y la validez de su solicitud y, a continuación, reinicialice la sesión.
409	ConflictException	Un reproductor ha intentado cargar varias listas de reproducción de forma simultánea para una única sesión. Como resultado, MediaTailor detectó un conflicto de coherencia en la sesión. Este problema aparece en los reproductores HLS.	Asegúrese de que el reproductor solicite listas de reproducción de una en una. Todo ello de conformidad con la especificación HLS.
410	Gone	Un operador de AWS Support ha bloqueado la sesión de un jugador o la configuración del cliente. AWS Support lo hace en raras circunstancias cuando detectamos un volumen muy alto de 4xx solicitudes provenientes de un tráfico errante para una sola sesión o configuración.	Si cree que la solicitud no debería bloquearse, póngase en contacto con AWS Support. Ellos pueden investigar el problema y eliminar el filtro de bloqueo, si procede.

Si necesita más ayuda, póngase en contacto con AWS Support.

Errores de reproducción del servidor devueltos por AWS Elemental MediaTailor

Guía general:

• Puedes encontrar información detallada sobre la mayoría de los errores en los encabezados y el cuerpo de la respuesta.

• En el caso de algunos errores, debes comprobar los ajustes de configuración. Puede recuperar los ajustes de su configuración de reproducción desdeAWS Elemental MediaTailor. Para la API, el recurso esGetPlaybackConfiguration/Name. Para obtener más información, consulta la referencia AWS Elemental MediaTailor de la API.

En la siguiente tabla se enumeran los códigos de error de servidor que devuelven las actividades de manipulación de manifiestos de AWS Elemental MediaTailor, las causas probables del error y las medidas que puede tomar para resolverlos.

Code	Nombre de la excepción	Significado	Solución
500	InternalServiceError	Excepción no adminsitrada.	Intente realizar de nuevo la solicitud . Si el problema persiste, compruebe el estado registrado MediaTailor de su AWS región enhttps://status.aws.amazon.com/.
502	BadGatewayException	La dirección del servidor de origen o la dirección del servidor de decisiones publicitarias (ADS) no son válidas. Las direcciones no válidas pueden ser una dirección IP privada y localhost.	Asegúrese de que la configuración del ADS y del servidor de origen son correctas y, a continuación, vuelva a enviar la solicitud.
502	UnsupportedManifestException	O bien el manifiesto de origen ha cambiado, por lo que no se MediaTailor puede personalizar o MediaTailor no es compatible con el formato del manifiesto de origen.	Esto podría afectar únicamente a una sesión individual. Reinicialice la sesión. En general, puede hacerlo actualizando la página en el visor. Si el problema persiste, compruebe que MediaTailor admite el formato del manifiesto del origen. Para obtener información, consulte Integrar una fuente de contenido.
503	LoadShed	MediaTailor sufrió una limitación de recursos al atender tu solicitud.	Intente realizar de nuevo la solicitud . Si el problema persiste, compruebe el estado registrado MediaTailor de su AWS región enhttps://status.aws.amazon.com/.
503	ThrottlingException	Se ha alcanzado la cuota establecida para las transacciones por segundo y MediaTailor está limitando su uso.	Intente realizar de nuevo la solicitud . También puede comprobar el estado de MediaTailor en su región de AWS en https://status.aws.amazon.com/. Le recomendamos que incremente su cuota de transacciones por segundo. Para obtener más información, consulte Cuotas de inserción de anuncios.
504	GatewayTimeoutException	Se ha agotado el tiempo de espera mientras MediaTailor estaba contactando con el servidor de origen.	Intente realizar de nuevo la solicitud . Si el problema persiste, compruebe el estado del servidor de origen y asegúrese de que el servidor de origen responde dentro del tiempo de espera del servidor de origen de contenido que se enumera en Cuotas de inserción de anuncios.

Si necesita más ayuda, póngase en contacto con AWS Support.

Ejemplos de errores de reproducción

En esta sección se enumeran algunos ejemplos de errores de reproducción que puede ver en las interacciones de la línea de comandos con AWS Elemental MediaTailor.

En el siguiente ejemplo, se muestra el resultado cuando se agota el tiempo de espera entre AWS Elemental MediaTailor el servidor de decisiones publicitarias (ADS) o el servidor de origen.

~[]> 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]"}%