Résolution des erreurs de lecture renvoyées par MediaTailor - AWS Elemental MediaTailor

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Résolution des erreurs de lecture renvoyées par MediaTailor

Cette section fournit des informations sur les codes HTTP d'erreur que vous pouvez recevoir lors du test du logiciel de lecture et lors du traitement normal des demandes des joueurs.

Note

Il est également possible que vous receviez des erreurs provenant du AWS Elemental MediaTailor API, lors d'opérations de configuration telles que PutPlaybackConfiguration etGetPlaybackConfiguration. Pour plus d'informations sur ces types d'erreurs, consultez le AWS Elemental MediaTailor APIRéférence.

Lorsque votre joueur envoie une demande à AWS Elemental MediaTailor, directement ou via unCDN, MediaTailor répond avec un code d'état. Si la demande est traitée MediaTailor avec succès, elle renvoie le code 200 OK d'HTTPétat indiquant le succès, ainsi que le manifeste rempli. Si la demande échoue, MediaTailor renvoie un code d'HTTPétat, un nom d'exception et un message d'erreur.

AWS Elemental MediaTailor renvoie deux classes d'erreurs :

  • Erreurs du client : erreurs généralement causées par un problème lié à la demande elle-même, comme une demande mal formatée, un paramètre non valide ou incorrect. URL Ces erreurs sont associées à un code de HTTP 4xx réponse.

  • Erreurs de serveur : erreurs généralement causées par un problème lié MediaTailor à l'une de ses dépendances, comme le serveur ad decision (ADS) ou le serveur d'origine. Ces erreurs sont associées à un code de HTTP 5xx réponse.

Erreurs de lecture du client renvoyées par AWS Elemental MediaTailor

Conseils généraux :

  • Vous trouverez des informations détaillées sur la plupart des erreurs dans les en-têtes et le corps de la réponse.

  • Pour détecter certaines erreurs, vous devez vérifier vos paramètres de configuration. Vous pouvez récupérer les paramètres de votre configuration de lecture sur AWS Elemental MediaTailor. Pour leAPI, la ressource estGetPlaybackConfiguration/Name. Pour plus de détails, consultez le AWS Elemental MediaTailor APIRéférence.

Le tableau suivant répertorie les codes d'erreur client renvoyés par les activités de manipulation du manifeste de AWS Elemental MediaTailor, les causes probables et les mesures que vous pouvez prendre pour les résoudre.

Code Nom de l'exception Signification Que faire
400 BadRequestException MediaTailor n'est pas en mesure de traiter la demande en raison d'une ou de plusieurs erreurs de formatage ou de contenu. Un paramètre est peut-être mal formaté ou la demande peut contenir une configuration de lecture ou un ID de session non valide. Vérifiez que votre demande est correctement formatée et contient des informations précises. Assurez-vous que le paramètre du point de terminaison de lecture sur le lecteur correspond au paramètre ManifestEndpointPrefix renvoyé par GetPlaybackConfiguration. Réessayez votre demande.
403 AccessDeniedException L'en-tête d'hôte fourni dans la demande ne correspond pas au préfixe du point de terminaison du manifeste configuré lors de la MediaTailor lectureURL. CDNIl se peut que vous soyez mal configuré. Vérifiez vos CDN paramètres et assurez-vous que vous utilisez le préfixe de point de terminaison du manifeste correct pour MediaTailor. Réessayez votre demande.
404 NotFoundException MediaTailor ne trouve pas les informations spécifiées. Les raisons possibles incluent une URL absence de correspondance avec un élément du service, une configuration non définie ou une session indisponible. Vérifiez votre configuration et la validité de votre demande, puis réinitialisez la session.
409 ConflictException Un lecteur a essayé de charger plusieurs listes de lecture simultanément pour une seule session. Par conséquent, un conflit de cohérence de session a MediaTailor été détecté. Ce problème se produit pour HLS les joueurs. Assurez-vous que votre lecteur demande les listes de lecture une à la fois. Ceci est conforme au HLS cahier des charges.
410 Gone Un AWS Support L'opérateur a bloqué une session de joueur ou une configuration client. AWS Support le fait dans de rares circonstances lorsque nous détectons un très grand nombre de demandes 4xx provenant d'un trafic errant pour une seule session ou configuration. Si vous pensez que la demande ne doit pas être bloquée, contactez le AWSSupport. Ils peuvent vérifier et supprimer le filtre à l'origine du blocage, le cas échéant.

Si vous avez besoin d'une assistance supplémentaire, contactez AWSle Support.

Erreurs de lecture du serveur renvoyées par AWS Elemental MediaTailor

Conseils généraux :

  • Vous trouverez des informations détaillées sur la plupart des erreurs dans les en-têtes et le corps de la réponse.

  • Pour détecter certaines erreurs, vous devez vérifier vos paramètres de configuration. Vous pouvez récupérer les paramètres de votre configuration de lecture sur AWS Elemental MediaTailor. Pour leAPI, la ressource estGetPlaybackConfiguration/Name. Pour plus de détails, consultez le AWS Elemental MediaTailor APIRéférence.

Le tableau suivant répertorie les codes d'erreur du serveur renvoyés par les activités de manipulation du manifeste de AWS Elemental MediaTailor, les causes probables et les mesures que vous pouvez prendre pour les résoudre.

Code Nom de l'exception Signification Que faire
500 InternalServiceError Exception non gérée Réitérez la requête . Si le problème persiste, vérifiez l'état de santé signalé MediaTailor pour votre AWS Région àhttps://status.aws.amazon.com/.
502 BadGatewayException L'adresse du serveur d'origine ou celle du serveur de décision publicitaire (ADS) n'est pas valide. Des exemples d'adresses non valides sont une adresse IP privée et localhost. Assurez-vous que votre configuration comporte les bons paramètres pour votre serveur ADS et pour le serveur d'origine, puis réessayez la demande.
502 UnsupportedManifestException Soit le manifeste d'origine a été modifié, ce qui ne MediaTailor permet pas de le personnaliser, soit il MediaTailor ne prend pas en charge le format du manifeste d'origine. Cela peut affecter uniquement une session individuelle. Réinitialisez la session. Vous pouvez généralement effectuer cette opération en actualisant la page dans le lecteur. Si le problème persiste, vérifiez que le format du manifeste de l'origine est MediaTailor compatible. Pour plus d’informations, veuillez consulter Intégration d'une source de contenu.
503 LoadShed MediaTailor a connu une contrainte de ressources lors du traitement de votre demande. Réitérez la requête . Si le problème persiste, vérifiez l'état de santé signalé MediaTailor pour votre AWS Région àhttps://status.aws.amazon.com/.
503 ThrottlingException Vos transactions par seconde ont atteint votre quota, MediaTailor ce qui limite votre utilisation. Réitérez la requête . Vous pouvez également vérifier l'état de santé déclaré MediaTailor de votre AWS Région àhttps://status.aws.amazon.com/. Vous pouvez augmenter le quota sur vos transactions par seconde. Pour de plus amples informations, veuillez consulter Quotas d'insertion de publicités.
504 GatewayTimeoutException Un délai d'attente s'est produit lors MediaTailor du contact avec le serveur d'origine. Réitérez la requête . Si le problème persiste, vérifiez l'état du serveur d'origine et assurez-vous que le serveur d'origine répond dans le délai d'attente du serveur d'origine du contenu répertorié à l'adresse Quotas d'insertion de publicités.

Si vous avez besoin d'une assistance supplémentaire, contactez AWSle Support.

Exemples d'erreurs de lecture

Cette section répertorie quelques exemples d'erreurs de lecture que vous pouvez rencontrer lors des interactions en ligne de commande avec AWS Elemental MediaTailor.

L'exemple suivant montre le résultat lorsqu'un délai d'attente survient entre AWS Elemental MediaTailor et soit le serveur de décision publicitaire (ADS), soit le serveur d'origine.

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