Behebung von Wiedergabefehlern, die zurückgegeben wurden von MediaTailor

Dieser Abschnitt enthält Informationen über die HTTP-Fehlercodes, die Sie möglicherweise beim Testen Ihrer Player-Software und während der normalen Verarbeitung von Player-Anforderungen erhalten.

Anmerkung

Sie erhalten möglicherweise auch Fehler von der AWS Elemental MediaTailor-API bei Konfigurationsoperationen wie PutPlaybackConfiguration und GetPlaybackConfiguration. Informationen zu diesen Fehlertypen finden Sie in der AWS Elemental MediaTailorAPI-Referenz.

Wenn dein Spieler direkt oder über ein CDN eine Anfrage an sendet, MediaTailor antwortet er mit einem Statuscode. AWS Elemental MediaTailor Wenn die Anfrage MediaTailor erfolgreich bearbeitet wurde, wird der HTTP-Statuscode200 OK, der den Erfolg anzeigt, zusammen mit dem ausgefüllten Manifest zurückgegeben. Wenn die Anfrage nicht erfolgreich ist, werden ein HTTP-Statuscode, ein Ausnahmename und eine Fehlermeldung MediaTailor zurückgegeben.

AWS Elemental MediaTailor gibt zwei Klassen von Fehlern zurück:

• Clientfehler — Fehler, die normalerweise durch ein Problem in der Anfrage selbst verursacht werden, z. B. durch eine falsch formatierte Anfrage, einen ungültigen Parameter oder eine fehlerhafte URL. Diese Fehler haben einen HTTP- 4xx-Antwort-Code.

• Serverfehler — Fehler, die normalerweise durch ein Problem mit MediaTailor oder einer seiner Abhängigkeiten verursacht werden, z. B. durch den Ad Decision Server (ADS) oder den Ursprungsserver. Diese Fehler haben einen HTTP- 5xx-Antwort-Code.

Client-Wiedergabefehler wurden zurückgegeben von AWS Elemental MediaTailor

Allgemeine Hinweise:

• Detaillierte Informationen zu den meisten Fehlern finden Sie in den Kopfzeilen und im Hauptteil der Antwort.

• Bei einigen Fehlern müssen Sie Ihre Konfigurationseinstellungen überprüfen. Sie können die Einstellungen für Ihre Wiedergabekonfiguration von abrufenAWS Elemental MediaTailor. Für die API ist die RessourceGetPlaybackConfiguration/Name. Einzelheiten finden Sie in der AWS Elemental MediaTailorAPI-Referenz.

In der folgenden Tabelle werden die Client-Fehlercodes aufgelistet, die durch die Manifest-Manipulierungsaktivitäten von AWS Elemental MediaTailor zurückgegeben werden, sowie mögliche Ursachen und Maßnahmen, die Sie ergreifen können, um diese Probleme zu beheben.

Code	Name der Ausnahme	Bedeutung	Vorgehensweise
400	BadRequestException	MediaTailor kann die Anfrage aufgrund eines oder mehrerer Formatierungs- oder Inhaltsfehler nicht bearbeiten. Ein Parameter ist möglicherweise nicht ordnungsgemäß formatiert oder die Anforderung enthält möglicherweise eine ungültige Playback-Konfiguration oder Sitzungs-ID.	Stellen Sie sicher, dass Ihre Anforderung ordnungsgemäß formatiert ist und korrekte Informationen enthält. Stellen Sie sicher, dass die Einstellung des Wiedergabe-Endpunkts am Player mit der ManifestEndpointPrefix-Einstellung übereinstimmt, die von GetPlaybackConfiguration zurückgegeben wird. Wiederholen Sie Ihre Anforderung.
403	AccessDeniedException	Der in der Anforderung angegebene Host-Header stimmt nicht mit dem Präfix des Manifest-Endpunkts über ein, das in der MediaTailor-Wiedergabe-URL konfiguriert ist. Ihr CDN ist möglicherweise falsch konfiguriert.	Überprüfen Sie Ihre CDN-Einstellungen und stellen Sie sicher, dass Sie das richtige Präfix des Manifest-Endpunkts für MediaTailor verwenden. Wiederholen Sie Ihre Anforderung.
404	NotFoundException	MediaTailor kann die angegebenen Informationen nicht finden. Mögliche Gründe sind eine URL, die keiner Entsprechung im Service zugeordnet ist, eine nicht definierte Konfiguration oder eine nicht verfügbare Sitzung.	Überprüfen Sie Ihre Konfiguration und die Gültigkeit Ihrer Anforderung und initialisieren Sie die Session dann neu.
409	ConflictException	Ein Player hat versucht, für eine einzige Sitzung mehrere Wiedergabelisten gleichzeitig zu laden. Infolgedessen MediaTailor wurde ein Sitzungskonsistenzkonflikt festgestellt. Dieses Problem tritt bei HLS-Playern auf.	Stellen Sie sicher, dass Ihr Player nur jeweils eine Wiedergabeliste anfordert. Dies stimmt mit der HLS-Spezifikation überein.
410	Gone	Ein AWS Support-Mitarbeiter hat eine Spielersitzung oder Kundenkonfiguration blockiert. AWS Der Support tut dies in seltenen Fällen, wenn wir eine sehr hohe Anzahl von 4xx-Anfragen feststellen, die auf fehlerhaften Datenverkehr für eine einzelne Sitzung oder Konfiguration zurückzuführen sind.	Wenn Sie der Meinung sind, dass die Anfrage nicht blockiert werden sollte, wenden Sie sich an den AWS-Support. Sie können das überprüfen und nötigenfalls den Blockfilter entfernen.

Wenn Sie weitere Support benötigen, wenden Sie sich an den AWS-Support.

Serverwiedergabefehler wurden zurückgegeben von AWS Elemental MediaTailor

Allgemeine Hinweise:

• Detaillierte Informationen zu den meisten Fehlern finden Sie in den Kopfzeilen und im Hauptteil der Antwort.

• Bei einigen Fehlern müssen Sie Ihre Konfigurationseinstellungen überprüfen. Sie können die Einstellungen für Ihre Wiedergabekonfiguration von abrufenAWS Elemental MediaTailor. Für die API ist die RessourceGetPlaybackConfiguration/Name. Einzelheiten finden Sie in der AWS Elemental MediaTailorAPI-Referenz.

In der folgenden Tabelle werden die Server-Fehlercodes aufgelistetet, die von den Manifest-Verarbeitungsaktivitäten von AWS Elemental MediaTailor zurückgegeben werden, sowie mögliche Ursachen und Maßnahmen, die Sie ergreifen können, um diese Probleme zu beheben.

Code	Name der Ausnahme	Bedeutung	Vorgehensweise
500	InternalServiceError	Unbehandelte Ausnahme	Wiederholen Sie die -Anforderung. Wenn das Problem weiterhin besteht, überprüfen Sie den gemeldeten Status von MediaTailor für Ihre AWS Region unterhttps://status.aws.amazon.com/.
502	BadGatewayException	Entweder die Adresse des Ursprungsservers oder die Adresse des Ad Decision Servers (ADS) ist ungültig. Beispiele für ungültige Adressen sind eine private IP-Adresse und localhost.	Stellen Sie sicher, dass Ihre Konfiguration über die richtigen Einstellungen für Ihren ADS und Ursprungs-Server verfügt, und wiederholen Sie die Anforderung.
502	UnsupportedManifestException	Entweder wurde das Ursprungsmanifest geändert, sodass es nicht personalisiert werden MediaTailor kann, oder es unterstützt das Manifestformat des Ursprungs MediaTailor nicht.	Dies wirkt sich möglicherweise nur auf diese einzelne Sitzung aus. Initialisieren Sie die Sitzung erneut. Sie können dies gewöhnlich erreichen, indem Sie die Seite auf der Anzeige aktualisieren. Wenn das Problem weiterhin besteht, stellen Sie sicher, dass das Manifest-Format des Ursprungs-Servers von MediaTailor unterstützt wird. Weitere Informationen finden Sie unter Integration einer Inhaltsquelle.
503	LoadShed	MediaTailor bei der Bearbeitung Ihrer Anfrage kam es zu einer Ressourcenbeschränkung.	Wiederholen Sie die -Anforderung. Falls das Problem weiterhin besteht, überprüfen Sie den MediaTailor für Ihre AWS Region gemeldeten Status unterhttps://status.aws.amazon.com/.
503	ThrottlingException	Da Ihre Transaktionen pro Sekunde das für Sie geltende Kontingent erreicht haben, wird Ihre Nutzung von MediaTailor abgelehnt.	Wiederholen Sie die -Anforderung. Sie können auch den gemeldeten Zustand von MediaTailor für Ihre AWS-Region unter https://status.aws.amazon.com/ überprüfen. Möglicherweise möchten Sie das Kontingent für Ihre Transaktionen pro Sekunde erhöhen. Weitere Informationen finden Sie unter Kontingente für das Einfügen von Anzeigen.
504	GatewayTimeoutException	Bei der Kontaktaufnahme mit dem Ursprungsserver ist ein Timeout aufgetreten MediaTailor .	Wiederholen Sie die -Anforderung. Wenn das Problem weiterhin besteht, überprüfen Sie den Zustand des Ursprungs-Servers und stellen Sie sicher, dass der Ursprungs-Server innerhalb des Timeouts des Ursprungs-Servers für Inhalte antwortet, das unter Kontingente für das Einfügen von Anzeigen aufgeführt wird.

Wenn Sie weitere Support benötigen, wenden Sie sich an den AWS-Support.

Beispiele für Fehler bei der Wiedergabe

In diesem Abschnitt werden einige Beispiele für Wiedergabefehler aufgelistet, die möglicherweise in Befehlszeilen-Interaktionen mit AWS Elemental MediaTailor angezeigt werden.

Das folgende Beispiel zeigt das Ergebnis, wenn ein Timeout zwischen dem AWS Elemental MediaTailor Ad Decision Server (ADS) oder dem Ursprungsserver auftritt.

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