Memecahkan masalah kesalahan pemutaran yang dikembalikan oleh MediaTailor - AWS Elemental MediaTailor

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memecahkan masalah kesalahan pemutaran yang dikembalikan oleh MediaTailor

Bagian ini memberikan informasi tentang kode HTTP kesalahan yang mungkin Anda terima saat menguji perangkat lunak pemain Anda dan selama pemrosesan normal permintaan pemain.

catatan

Anda mungkin juga menerima kesalahan dari AWS Elemental MediaTailor API, selama operasi konfigurasi seperti PutPlaybackConfiguration danGetPlaybackConfiguration. Untuk informasi tentang jenis kesalahan tersebut, lihat AWS Elemental MediaTailor APIReferensi.

Ketika pemain Anda mengirim permintaan ke AWS Elemental MediaTailor, baik secara langsung atau melaluiCDN, MediaTailor merespons dengan kode status. Jika MediaTailor berhasil menangani permintaan, ia mengembalikan kode HTTP status200 OK, menunjukkan keberhasilan, bersama dengan manifes yang diisi. Jika permintaan tidak berhasil, MediaTailor mengembalikan kode HTTP status, nama pengecualian, dan pesan kesalahan.

AWS Elemental MediaTailor mengembalikan dua kelas kesalahan:

  • Kesalahan klien — kesalahan yang biasanya disebabkan oleh masalah dalam permintaan itu sendiri, seperti permintaan yang tidak diformat dengan benar, parameter yang tidak valid, atau buruk. URL Kesalahan ini memiliki kode HTTP 4xx respons.

  • Kesalahan server — kesalahan yang biasanya disebabkan oleh masalah dengan MediaTailor atau salah satu dependensinya, seperti server keputusan iklan (ADS) atau server asal. Kesalahan ini memiliki kode HTTP 5xx respons.

Kesalahan pemutaran klien dikembalikan oleh AWS Elemental MediaTailor

Panduan umum:

  • Anda dapat menemukan informasi terperinci untuk sebagian besar kesalahan di header dan badan respons.

  • Untuk beberapa kesalahan, Anda perlu memeriksa pengaturan konfigurasi Anda. Anda dapat mengambil pengaturan untuk konfigurasi pemutaran Anda dari AWS Elemental MediaTailor. UntukAPI, sumber daya adalahGetPlaybackConfiguration/Name. Untuk detailnya, lihat AWS Elemental MediaTailor APIReferensi.

Tabel berikut mencantumkan kode kesalahan klien yang dikembalikan oleh aktivitas manipulasi manifes AWS Elemental MediaTailor, kemungkinan penyebab, dan tindakan yang dapat Anda ambil untuk menyelesaikannya.

Kode Nama pengecualian Arti Apa yang harus dilakukan
400 BadRequestException MediaTailor tidak dapat melayani permintaan karena satu atau beberapa kesalahan dalam pemformatan atau konten. Parameter mungkin tidak diformat dengan benar, atau permintaan mungkin berisi konfigurasi pemutaran atau ID sesi yang tidak valid. Periksa apakah permintaan Anda diformat dengan benar dan berisi informasi yang akurat. Pastikan bahwa pengaturan titik akhir pemutaran pada pemain cocok dengan ManifestEndpointPrefix pengaturan yang dikembalikan olehGetPlaybackConfiguration. Coba lagi permintaan Anda.
403 AccessDeniedException Header host yang disediakan dalam permintaan tidak cocok dengan awalan titik akhir manifes yang dikonfigurasi dalam MediaTailor pemutaran. URL Anda CDN mungkin salah konfigurasi. Periksa CDN pengaturan Anda dan pastikan bahwa Anda menggunakan awalan titik akhir manifes yang benar untuk. MediaTailor Coba lagi permintaan Anda.
404 NotFoundException MediaTailor tidak dapat menemukan informasi yang ditentukan. Alasan yang mungkin termasuk URL yang tidak memetakan ke apa pun dalam layanan, konfigurasi yang tidak ditentukan, atau sesi yang tidak tersedia. Periksa konfigurasi Anda dan validitas permintaan Anda, lalu inisialisasi ulang sesi.
409 ConflictException Seorang pemain mencoba memuat beberapa daftar putar secara bersamaan untuk satu sesi. Akibatnya, MediaTailor terdeteksi konflik konsistensi sesi. Masalah ini terjadi pada HLS pemain. Pastikan pemain Anda meminta daftar putar satu per satu. Hal ini sesuai dengan HLS spesifikasi.
410 Gone Sesi AWS Operator Support telah memblokir sesi pemain atau konfigurasi pelanggan. AWS Support melakukan ini dalam keadaan yang jarang terjadi ketika kami mendeteksi volume permintaan 4xx yang sangat tinggi yang berasal dari lalu lintas yang salah untuk satu sesi atau konfigurasi. Jika menurut Anda permintaan tidak boleh diblokir, hubungi AWSSupport. Mereka dapat melihat ke dalamnya dan menghapus filter pemblokiran, jika sesuai.

Jika Anda membutuhkan bantuan lebih lanjut, hubungi AWSSupport.

Kesalahan pemutaran server dikembalikan oleh AWS Elemental MediaTailor

Panduan umum:

  • Anda dapat menemukan informasi terperinci untuk sebagian besar kesalahan di header dan badan respons.

  • Untuk beberapa kesalahan, Anda perlu memeriksa pengaturan konfigurasi Anda. Anda dapat mengambil pengaturan untuk konfigurasi pemutaran Anda dari AWS Elemental MediaTailor. UntukAPI, sumber daya adalahGetPlaybackConfiguration/Name. Untuk detailnya, lihat AWS Elemental MediaTailor APIReferensi.

Tabel berikut mencantumkan kode kesalahan server yang dikembalikan oleh aktivitas manipulasi manifes AWS Elemental MediaTailor, kemungkinan penyebab, dan tindakan yang dapat Anda ambil untuk menyelesaikannya.

Kode Nama pengecualian Arti Apa yang harus dilakukan
500 InternalServiceError Pengecualian yang tidak tertangani. Coba lagi permintaannya. Jika masalah berlanjut, periksa kesehatan yang dilaporkan MediaTailor untuk Anda AWS Wilayah dihttps://status.aws.amazon.com/.
502 BadGatewayException Alamat server asal atau alamat server keputusan iklan (ADS) tidak valid. Contoh alamat yang tidak valid adalah alamat IP pribadi dan. localhost Pastikan konfigurasi Anda memiliki pengaturan yang benar untuk server asal ADS dan Anda, lalu coba lagi permintaannya.
502 UnsupportedManifestException Entah manifes asal telah berubah sehingga tidak MediaTailor dapat mempersonalisasikannya atau MediaTailor tidak mendukung format manifes asal. Ini mungkin hanya mempengaruhi sesi individu. Inisialisasi ulang sesi. Anda biasanya dapat melakukannya dengan menyegarkan halaman di pemirsa. Jika masalah berlanjut, verifikasi yang MediaTailor mendukung format manifes asal. Untuk informasi, lihat Mengintegrasikan sumber konten.
503 LoadShed MediaTailor mengalami kendala sumber daya saat melayani permintaan Anda. Coba lagi permintaannya. Jika masalah berlanjut, periksa kesehatan yang dilaporkan MediaTailor untuk Anda AWS Wilayah dihttps://status.aws.amazon.com/.
503 ThrottlingException Transaksi Anda per detik telah mencapai kuota Anda, dan MediaTailor membatasi penggunaan Anda. Coba lagi permintaannya. Anda juga dapat memeriksa kesehatan yang dilaporkan MediaTailor untuk Anda AWS Wilayah dihttps://status.aws.amazon.com/. Anda mungkin ingin meningkatkan kuota transaksi Anda per detik. Untuk informasi selengkapnya, lihat Kuota pada penyisipan iklan.
504 GatewayTimeoutException Batas waktu terjadi MediaTailor saat menghubungi server asal. Coba lagi permintaannya. Jika masalah berlanjut, periksa kesehatan server asal dan pastikan server asal merespons dalam batas waktu server asal konten yang tercantum di. Kuota pada penyisipan iklan

Jika Anda membutuhkan bantuan lebih lanjut, hubungi AWSSupport.

Contoh kesalahan pemutaran

Bagian ini mencantumkan beberapa contoh kesalahan pemutaran yang mungkin Anda lihat dalam interaksi baris perintah AWS Elemental MediaTailor.

Contoh berikut menunjukkan hasil ketika batas waktu terjadi antara AWS Elemental MediaTailor dan baik server keputusan iklan (ADS) atau server asal.

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