View a markdown version of this page

Risoluzione dei problemi di riproduzione da MediaTailor - AWS Elemental MediaTailor

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Risoluzione dei problemi di riproduzione da MediaTailor

Questa sezione fornisce informazioni sui codici di errore HTTP che potresti ricevere durante i test del software del lettore e durante la normale elaborazione delle richieste del lettore.

Nota

Potresti anche ricevere errori dall' AWS Elemental MediaTailor API, durante operazioni di configurazione come PutPlaybackConfiguration eGetPlaybackConfiguration. Per informazioni su questi tipi di errori, consulta l'AWS Elemental MediaTailor API Reference.

Quando il lettore invia una richiesta a AWS Elemental MediaTailor, direttamente o tramite un CDN, MediaTailor risponde con un codice di stato. Se la richiesta viene gestita MediaTailor correttamente, restituisce il codice di stato HTTP200 OK, indicante l'esito positivo, insieme al manifest compilato. Se la richiesta non va a buon fine, MediaTailor restituisce un codice di stato HTTP, un nome di eccezione e un messaggio di errore.

AWS Elemental MediaTailor restituisce due classi di errori:

  • Errori del client: errori che di solito sono causati da un problema nella richiesta stessa, ad esempio una richiesta formattata in modo errato, un parametro non valido o un URL errato. Questi errori hanno un codice di risposta HTTP 4xx.

  • Errori del server: errori che di solito sono causati da un problema MediaTailor o da una delle sue dipendenze, come l'ad decision server (ADS) o il server di origine. Questi errori hanno un codice di risposta HTTP 5xx.

Errori di riproduzione del client restituiti da AWS Elemental MediaTailor

Indicazioni generali:

  • Puoi trovare informazioni dettagliate per la maggior parte degli errori nelle intestazioni e nel corpo della risposta.

  • Per alcuni errori, è necessario controllare le impostazioni di configurazione. È possibile recuperare le impostazioni per la configurazione di riproduzione da AWS Elemental MediaTailor. Per l'API, la risorsa èGetPlaybackConfiguration/Name. Per i dettagli, consulta l'AWS Elemental MediaTailor API Reference.

La tabella seguente elenca i codici di errore del client restituiti dalle attività di manipolazione manifesta AWS Elemental MediaTailor, le cause probabili e le azioni che è possibile intraprendere per risolverli.

Codice Nome dell'eccezione Significato Cosa fare
400 BadRequestException MediaTailor non è in grado di soddisfare la richiesta a causa di uno o più errori di formattazione o di contenuto. Un parametro potrebbe essere formattato in modo errato oppure la richiesta potrebbe includere un ID sessione o una configurazione di riproduzione non validi. Verifica che la richiesta sia formattata correttamente e che contenga le informazioni necessarie. Verifica che l’impostazione dell’endpoint di riproduzione sul lettore corrisponda all’impostazione ManifestEndpointPrefix restituita da GetPlaybackConfiguration. Invia di nuovo la richiesta.
403 AccessDeniedException L'intestazione host fornita nella richiesta non corrisponde al prefisso dell’endpoint del manifest configurato nell’URL di riproduzione di MediaTailor. La rete CDN potrebbe non essere configurata correttamente. Controlla le impostazioni della rete CDN e verifica che il prefisso dell’endpoint del manifest utilizzato sia corretto per MediaTailor. Invia di nuovo la richiesta.
404 NotFoundException MediaTailor non è in grado di trovare le informazioni specificate. Questa situazione può verificarsi perché un URL non viene mappato ad alcun elemento del servizio, una configurazione non viene definita o una sessione non è disponibile. Controlla la configurazione e la validità della richiesta, quindi reinizializza la sessione.
409 ConflictException Un lettore ha provato a caricare più playlist contemporaneamente in una singola sessione. Di conseguenza, ha MediaTailor rilevato un conflitto di coerenza della sessione. Questo problema si verifica con i lettori HLS. Verifica che il lettore richieda una playlist alla volta. Questo è il comportamento conforme alle specifica HLS.
410 Gone Un operatore dell' AWS assistenza ha bloccato una sessione del giocatore o una configurazione del cliente. AWS L'assistenza esegue questa operazione in rare circostanze quando rileviamo un volume molto elevato di richieste 4xx provenienti da traffico errato per una singola sessione o configurazione. Se ritieni che la richiesta non debba essere bloccata, contatta AWS Support. Il supporto può esaminare il problema e rimuovere il filtro di blocco, se necessario.

Se hai bisogno di ulteriore assistenza, contatta AWS Support.

Errori di riproduzione del server restituiti da AWS Elemental MediaTailor

Indicazioni generali:

  • Puoi trovare informazioni dettagliate sulla maggior parte degli errori nelle intestazioni e nel corpo della risposta.

  • Per alcuni errori, è necessario controllare le impostazioni di configurazione. È possibile recuperare le impostazioni per la configurazione di riproduzione da AWS Elemental MediaTailor. Per l'API, la risorsa èGetPlaybackConfiguration/Name. Per i dettagli, consulta l'AWS Elemental MediaTailor API Reference.

La tabella seguente elenca i codici di errore del server restituiti dalle attività di manipolazione dei manifesti AWS Elemental MediaTailor, le cause probabili e le azioni che è possibile intraprendere per risolverli.

Codice Nome dell'eccezione Significato Cosa fare
500 InternalServiceError Eccezione non gestita. Riprova la richiesta . Se il problema persiste, controlla lo stato di salute segnalato MediaTailor per la tua AWS regione all'indirizzohttps://status.aws.amazon.com/.
502 BadGatewayException L'indirizzo del server di origine o l'indirizzo dell'ad decision server (ADS) non sono validi. Esempi di indirizzi non validi sono un indirizzo IP privato e localhost. Verifica che la configurazione abbia le impostazioni corrette per l’ADS e il server di origine, quindi ripeti la richiesta.
502 UnsupportedManifestException Il manifesto di origine è stato modificato, quindi non è MediaTailor possibile personalizzarlo o MediaTailor non supporta il formato del manifesto di origine. Questo potrebbe influire solo sulla singola sessione. Reinizializza la sessione. Per farlo, in genere basta aggiornare la pagina nel visualizzatore. Se il problema persiste, verifica che MediaTailor supporti il formato del manifest di origine. Per informazioni, consulta Integrazione di una fonte di contenuti.
503 LoadShed MediaTailor si è verificato un vincolo di risorse durante la gestione della richiesta. Riprova la richiesta . Se il problema persiste, controlla lo stato di salute segnalato MediaTailor per la tua AWS regione all'indirizzo. https://status.aws.amazon.com/
503 ThrottlingException Le transazioni al secondo hanno raggiunto la quota e MediaTailor sta limitando l'utilizzo. Riprova la richiesta . Puoi anche verificare lo stato di salute segnalato MediaTailor per la tua AWS regione all'indirizzohttps://status.aws.amazon.com/. Può essere opportuno aumentare il limite di quote al secondo. Per ulteriori informazioni, consulta Quote sull'inserimento degli annunci.
504 GatewayTimeoutException Si è verificato un timeout durante MediaTailor il contatto con il server di origine. Riprova la richiesta . Se il problema persiste, controlla lo stato del server di origine e verifica che stia rispondendo entro il timeout del server di origine del contenuto elencato in Quote sull'inserimento degli annunci.

Se hai bisogno di ulteriore assistenza, contatta AWS Support.

Esempi di errori di riproduzione

Questa sezione elenca alcuni esempi degli errori di riproduzione che potresti riscontrare nelle interazioni con la riga di comando AWS Elemental MediaTailor.

L'esempio seguente mostra il risultato quando si verifica un timeout tra AWS Elemental MediaTailor e l'ad decision server (ADS) o il server di 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]"}%