GetMediaForFragmentList - Amazon Kinesis Video Streams
Sintaks PermintaanURIParameter PermintaanIsi PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

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

GetMediaForFragmentList

Mendapat media untuk daftar fragmen (ditentukan berdasarkan nomor fragmen) dari data yang diarsipkan dalam aliran video Amazon Kinesis.

catatan

Anda harus terlebih dahulu memanggil GetDataEndpoint API untuk mendapatkan titik akhir. Kemudian kirim GetMediaForFragmentList permintaan ke titik akhir ini menggunakan parameter --endpoint-url.

Untuk batasan, lihat Kuota Kinesis Video Streams.

penting

Jika kesalahan muncul setelah menjalankan API media yang diarsipkan Kinesis Video Streams, selain kode status dan badan respons, itu mencakup potongan-potongan informasi berikut: HTTP

  • x-amz-ErrorTypeHTTPheader - berisi jenis kesalahan yang lebih spesifik selain apa yang disediakan kode HTTP status.

  • x-amz-RequestIdHTTPheader — jika Anda ingin melaporkan masalah AWS, tim dukungan dapat mendiagnosis masalah dengan lebih baik jika diberi ID Permintaan.

Baik kode HTTP status dan ErrorType header dapat digunakan untuk membuat keputusan terprogram tentang apakah kesalahan dapat dicoba ulang dan dalam kondisi apa, serta memberikan informasi tentang tindakan apa yang mungkin perlu dilakukan oleh programmer klien agar berhasil mencoba lagi.

Untuk informasi selengkapnya, lihat bagian Kesalahan di bagian bawah topik ini, serta Kesalahan Umum.

Sintaks Permintaan

POST /getMediaForFragmentList HTTP/1.1
Content-type: application/json

{
   "Fragments": [ "string" ],
   "StreamARN": "string",
   "StreamName": "string"
}

URIParameter Permintaan

Permintaan tidak menggunakan URI parameter apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam JSON format.

Fragments

Daftar jumlah fragmen untuk mengambil media. Anda mengambil nilai-nilai ini denganListFragments.

Tipe: Array string

Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 1000 item.

Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.

Pola: ^[0-9]+$

Wajib: Ya

StreamARN

Amazon Resource Name (ARN) dari aliran untuk mengambil media fragmen. Tentukan parameter ini atau StreamName parameternya.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 1024.

Pola: arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+

Wajib: Tidak

StreamName

Nama aliran dari mana untuk mengambil media fragmen. Tentukan parameter ini atau StreamARN parameternya.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.

Pola: [a-zA-Z0-9_.-]+

Diperlukan: Tidak

Sintaksis Respons

HTTP/1.1 200
Content-Type: ContentType

Payload

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Respons mengembalikan HTTP header berikut.

ContentType

Jenis konten media yang diminta.

Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.

Pola: ^[a-zA-Z0-9_\.\-]+$

Respons mengembalikan yang berikut sebagai HTTP tubuh.

Payload

Payload yang Kinesis Video Streams kembalikan adalah urutan potongan dari aliran yang ditentukan. Untuk informasi tentang potongan, lihat. PutMedia Potongan yang ditampilkan Kinesis Video Streams dalam panggilan juga menyertakan tag GetMediaForFragmentList Matroska () tambahan berikut: MKV

  • AWS_ KINESISVIDEO _ FRAGMENT _ NUMBER - Nomor fragmen dikembalikan dalam potongan.

  • AWS_ _ KINESISVIDEO _ SERVER SIDE _ TIMESTAMP - Stempel waktu sisi server dari fragmen.

  • AWS_ _ KINESISVIDEO _ PRODUCER SIDE _ TIMESTAMP - Stempel waktu sisi produsen dari fragmen.

Tag berikut akan disertakan jika pengecualian terjadi:

  • AWS_ KINESISVIDEO FRAGMENT _ _ NUMBER - Jumlah fragmen yang melemparkan pengecualian.

  • AWS_ KINESISVIDEO _ EXCEPTION _ ERROR _ CODE - Kode integer dari kesalahan.

  • AWSKINESISVIDEO_ EXCEPTION _ _ MESSAGE - Deskripsi teks pengecualian.

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

ClientLimitExceededException

Kinesis Video Streams telah membatasi permintaan karena Anda telah melampaui batas. Coba buat panggilan nanti. Untuk informasi tentang batasan, lihat Kuota Kinesis Video Streams.

HTTPKode Status: 400

InvalidArgumentException

Parameter yang ditentukan melebihi batasannya, tidak didukung, atau tidak dapat digunakan.

HTTPKode Status: 400

NotAuthorizedException

Kode Status: 403, Penelepon tidak berwenang untuk melakukan operasi pada aliran yang diberikan, atau token telah kedaluwarsa.

HTTPKode Status: 401

ResourceNotFoundException

GetImagesakan memunculkan kesalahan ini ketika Kinesis Video Streams tidak dapat menemukan aliran yang Anda tentukan.

GetHLSStreamingSessionURLdan GetDASHStreamingSessionURL membuang kesalahan ini jika sesi dengan PlaybackMode dari ON_DEMAND atau LIVE_REPLAY diminta untuk aliran yang tidak memiliki fragmen dalam rentang waktu yang diminta, atau jika sesi dengan PlaybackMode of LIVE diminta untuk aliran yang tidak memiliki fragmen dalam 30 detik terakhir.

HTTPKode Status: 404

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini: