Kuota layanan Amazon Kinesis Video Streams - Amazon Kinesis Video Streams
Kontrol kuota API layanan pesawatKuota layanan media dan media arsip APIKuota fragmen-metadata dan fragmen-mediaKuota layanan metadata streamingSDKKuota produsen

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

Kuota layanan Amazon Kinesis Video Streams

Kinesis Video Streams memiliki kuota layanan berikut:

penting

Kuota layanan berikut adalah soft [s], yang dapat ditingkatkan dengan mengirimkan tiket dukungan, atau hard [h], yang tidak dapat ditingkatkan. Anda akan melihat [s] dan [h] di samping kuota layanan individual pada tabel di bawah ini.

Kontrol kuota API layanan pesawat

Bagian berikut menjelaskan kuota layanan untuk bidang APIs kontrol. TPSsingkatan dari transaksi per detik.

Ketika batas permintaan tingkat akun atau tingkat sumber daya tercapai, a dilemparkan. ClientLimitExceededException

API Batas akun: Permintaan Batas akun: Streams Batas tingkat aliran Pengecualian dan catatan yang relevan
CreateStream 50 TPS [s] 10.000 aliran per akun di semua Wilayah yang didukung.
catatan

Batas ini dapat ditingkatkan hingga 100.000 (atau lebih) aliran per akun. Masuk ke AWS Management Console at https://console.aws.amazon.com/ dan minta peningkatan batas ini.

Perangkat,CLIs, akses SDK yang digerakkan, dan konsol semuanya dapat memanggil ini. API Hanya satu API panggilan yang berhasil jika aliran belum ada.
DeleteEdgeConfiguration 10 TPS [h] N/A 1 TPS [h]
DeleteStream 50 TPS [h] N/A 5 TPS [h]
DescribeEdgeConfiguration 50 TPS [h] N/A 5 TPS [h]
DescribeImageGenerationConfiguration 50 TPS [h] N/A 5 TPS [h]
DescribeMappedResourceConfiguration 50 TPS [h] N/A 5 TPS [h]
DescribeNotificationConfiguration 50 TPS [h] N/A 5 TPS [h]
DescribeStream 300 TPS [h] N/A 5 TPS [h]
GetDataEndpoint 300 TPS [h] N/A 5 TPS [h] Dipanggil setiap 45 menit untuk menyegarkan token streaming untuk sebagian PutMedia besar/kasus GetMedia penggunaan. Caching data endpoint aman jika aplikasi memuat ulang mereka pada kegagalan.
ListEdgeAgentConfigurations 50 TPS [h] N/A N/A
ListStreams 50 TPS [h] N/A
ListTagsForStream 50 TPS [h] N/A 5 TPS [h]
StartEdgeConfigurationUpdate 10 TPS [h] N/A 1 TPS [h]
TagStream 50 TPS [h] N/A 5 TPS [h]
UntagStream 50 TPS [h] N/A 5 TPS [h]
UpdateDataRetention 50 TPS [h] N/A 5 TPS [h]
UpdateImageGenerationConfiguration 50 TPS [h] N/A 5 TPS [h]
UpdateNotificationConfiguration 50 TPS [h] N/A 5 TPS [h]
UpdateStream 50 TPS [h] N/A 5 TPS [h]

Kuota layanan media dan media arsip API

Bagian berikut menjelaskan kuota layanan untuk media dan media yang diarsipkan. APIs

Ketika batas permintaan tingkat akun atau tingkat sumber daya tercapai, a dilemparkan. ClientLimitExceededException

Ketika batas tingkat koneksi tercapai, a ConnectionLimitExceededException dilemparkan.

Kesalahan atau acks berikut dilemparkan ketika batas tingkat fragmen tercapai:

  • MIN_FRAGMENT_DURATION_REACHEDAck dikembalikan untuk fragmen di bawah durasi minimum.

  • MAX_FRAGMENT_DURATION_REACHEDAck dikembalikan untuk fragmen di atas durasi maksimum.

  • MAX_FRAGMENT_SIZEAck dikembalikan untuk fragmen di atas ukuran data maksimum.

  • FragmentLimitExceededPengecualian dilemparkan jika batas fragmen tercapai dalam suatu GetMediaForFragmentList operasi.

Kuota API layanan pesawat data

API Batas tingkat aliran Batas tingkat koneksi Batas bandwidth Batas tingkat fragmen Pengecualian dan catatan yang relevan
PutMedia 5 TPS [h] 1 [s] 12,5 MB/detik, atau 100 Mbps per aliran

  • Durasi fragmen minimum: 1 detik [h]

  • Durasi fragmen maksimum: 20 detik [h]

  • Ukuran fragmen maksimum: 50 MB [h]

  • Jumlah maksimum trek: 3 [s]

  • Fragmen maksimum yang dikirim per detik: 5 [h]

  • Batas metadata fragmen maksimum: 10 tag [h]

 PutMediaPermintaan tipikal berisi data selama beberapa detik, menghasilkan TPS per aliran yang lebih rendah. Jika ada beberapa koneksi bersamaan yang melebihi kuota, koneksi terakhir diterima.
GetClip N/A N/A Batas ukuran 100 MB [h] Jumlah fragmen maksimum: 200 [h]
etDASHStreamingSesi G URL 25 TPS [h] N/A N/A N/A
etHLSStreamingSesi G URL 25 TPS [h] N/A N/A N/A
GetImages N/A N/A 100 MB [h] N/A

Jumlah maksimum gambar per permintaan adalah 100 [h].

catatan

Nilai minimum untuk SamplingInterval adalah 200 milidetik (ms), yaitu 5 gambar per detik.
GetMedia 5 TPS [h] 3 [s] 25 MB/s atau 200 Mbps [s] Maksimal 5 fragmen yang dikirim per detik [h]

Klien konsumen yang unik tidak perlu lebih dari dua atau tiga TPS karena setelah koneksi dibuat, aplikasi harus terus membaca.

Jika fragmen tipikal kira-kira 5 MB, batas ini berarti ~75 per aliran video MBps Kinesis. Aliran seperti itu akan memiliki bitrate keluar 2x bitrate masuk maksimum aliran.

catatan

GetMediatidak digunakan HLS DASH untuk/pemutaran.
GetMediaForFragmentList N/A 5 [s] 25 MB/s atau 200 Mbps [s] Jumlah fragmen maksimum: 1000 [h] Lima aplikasi konsumsi berbasis fragmen dapat digunakan secara bersamaan. GetMediaForFragmentList Koneksi lebih lanjut ditolak.

Kuota API layanan protokol pemutaran video

API Batas tingkat sesi Batas tingkat fragmen
Daftar etDASHManifest Putar G 5 TPS [h] Jumlah maksimum fragmen per daftar putar: 5.000 [h]
Daftar etHLSMaster Putar G 5 TPS [h] N/A
Daftar etHLSMedia Putar G 5 TPS [h] Jumlah maksimum fragmen per daftar putar: 5.000 [h]
Dapatkan MP4InitFragment 5 TPS [h] N/A
Dapatkan MP4MediaFragment 20 TPS [h] N/A
G etTSFragment 20 TPS [h] N/A

Kuota fragmen-metadata dan fragmen-media

Kinesis APIsVideo Streams untuk mengakses media yang diarsipkan dibatasi berdasarkan jumlah fragmen yang diminta daripada jumlah panggilan. API APIsdibatasi oleh jumlah metadata fragmen dan jumlah media fragmen yang diminta. Metadata fragmen dan kuota media fragmen diterapkan per aliran. Dengan kata lain, permintaan untuk metadata fragmen atau media dalam satu aliran tidak berlaku untuk kuota aliran lain. Namun, dalam aliran tertentu, setiap kuota dibagi di beberapaAPIs. Ini berarti bahwa, untuk aliran tertentu, meminta fragmen di seluruh APIs konsumsi yang berbeda dari kuota yang sama. Ketika metadata fragmen atau kuota media fragmen untuk aliran terlampaui, maka akan mengembalikan a. API ClientLimitExceededException Tabel berikut menunjukkan bagaimana APIs konsumsi dari masing-masing dari dua jenis kuota. Untuk kolom kedua dalam tabel ini, asumsikan bahwa jika aliran memiliki kuota N, itu berarti APIs memiliki poin N untuk dikonsumsi dari jenis kuota untuk aliran itu. GetClipAPIMuncul di kedua tabel.

Konsumsi kuota fragmen-metadata

API Jumlah poin kuota yang dikonsumsi per permintaan Kuota bersama (N)
ListFragments Nilai MaxResults parameter 10.000 poin kuota per detik, per aliran [h]
GetClip Jumlah fragmen dalam klip yang dihasilkan
GetHLSMediaPlaylist Nilai MaxMediaPlaylistFragmentResults parameter
GetDASHManifest Nilai MaxManifestFragmentResults parameter
GetImages Nilai 400+jumlah maksimum gambar yang diminta

Konsumsi kuota fragmen-media

API Jumlah poin kuota yang dikonsumsi per permintaan Kuota bersama (N)
GetMediaForFragmentList Jumlah fragmen dalam parameter Fragmen 500 poin kuota per detik, per aliran [h]
GetClip Jumlah fragmen dalam klip yang dihasilkan
GetMP4MediaFragment 1
GetTSFragment 1
GetImages Jumlah maksimum gambar yang diminta

Misalnya, dengan kuota 500 media fragmen per detik, pola panggilan berikut untuk aliran tertentu didukung:

  • 5 permintaan per detik untuk GetClip dengan 100 fragmen di setiap klip.

  • 100 permintaan per detik untuk GetClip dengan 5 fragmen di setiap klip.

  • 2 permintaan per detik untuk GetClip dengan 100 fragmen di setiap klip dan 3 permintaan per detik untuk GetMediaForFragmentList di setiap klip.

  • 400 permintaan per detik untuk GetMP4MediaFragment dan 100 permintaan per detik untukGetTSFragment.

Kuota ini memiliki implikasi penting mengenai jumlah HLS dan MPEG - DASH sesi yang dapat didukung per aliran. Tidak ada batasan jumlah HLS dan DASH sesi yang dapat digunakan oleh pemutar media pada waktu tertentu. Oleh karena itu, penting bahwa aplikasi pemutaran tidak mengizinkan terlalu banyak sesi untuk digunakan secara bersamaan. Dua contoh berikut menjelaskan cara menentukan jumlah sesi pemutaran bersamaan yang dapat didukung:

Contoh 1: Streaming langsung

Dalam skenario streaming langsung HLS dengan fragmen durasi 1 detik, trek audio dan video, dan MaxMediaPlaylistFragmentResults diatur ke lima, pemutar media biasanya membuat dua panggilan GetHLSMediaPlaylist per detik. Satu panggilan adalah untuk metadata video terbaru dan satu lagi untuk metadata audio yang sesuai. Kedua panggilan tersebut mengkonsumsi masing-masing lima poin kuota metadata fragmen. Itu juga membuat dua panggilan GetMP4MediaFragment per detik: satu panggilan untuk video terbaru dan satu lagi untuk audio yang sesuai. Setiap panggilan mengkonsumsi satu token media fragmen, sehingga dua token dikonsumsi secara total.

Dalam skenario ini, hingga 250 sesi pemutaran bersamaan dapat didukung. Dengan 250 sesi, skenario ini mengkonsumsi 2.500 poin kuota metadata fragmen per detik (jauh di bawah kuota 10.000) dan 500 poin kuota media fragmen per detik.

Contoh 2: Pemutaran sesuai permintaan

Dalam skenario pemutaran sesuai permintaan dari peristiwa sebelumnya dengan MPEG -DASH, trek audio dan video dan MaxManifestFragmentResults disetel ke 1.000, pemutar media biasanya menelepon GetDASHManifest sekali pada awal sesi (mengkonsumsi 1.000 poin kuota metadata fragmen) dan panggilan GetMP4MediaFragment dengan kecepatan hingga 5 kali per detik (mengkonsumsi 5 poin kuota media fragmen) hingga semua fragmen dimuat. Dalam skenario ini, hingga 10 sesi baru dapat dimulai per detik (tepat di 10.000 metadata fragmen per detik kuota), dan hingga 100 sesi dapat secara aktif memuat media fragmen dengan kecepatan 5 per detik (tepat di 500 fragmen media per detik kuota).

Anda dapat menggunakan ArchivedFragmentsConsumed.Metadata dan ArchivedFragmentsConsumed.Media memantau konsumsi metadata fragmen dan titik kuota media fragmen, masing-masing. Untuk informasi tentang pemantauan, lihatMemantau Aliran Video Amazon Kinesis.

Kuota layanan metadata streaming

Kuota layanan berikut berlaku untuk menambahkan metadata streaming ke aliran video Kinesis:

  • Anda dapat menambahkan hingga 10 item metadata ke sebuah fragmen.

  • Nama metadata fragmen dapat mencapai panjang 128 byte.

  • Nilai metadata fragmen bisa mencapai 256 byte panjangnya.

  • Nama metadata fragmen tidak dapat dimulai dengan string "”. AWS Jika item metadata tersebut ditambahkan, putFragmentMetadata metode dalam PIC mengembalikan STATUS_INVALID_METADATA_NAME kesalahan (kode 0x52000077 kesalahan). Aplikasi Anda kemudian dapat mengabaikan kesalahan (PICtidak menambahkan item metadata), atau menanggapi kesalahan.

SDKKuota produsen

Tabel berikut berisi kuota saat ini untuk nilai-nilai dalam. SDK Untuk informasi selengkapnya, lihat Unggah ke Kinesis Video Streams.

catatan

Sebelum menetapkan nilai-nilai ini, Anda harus memvalidasi input Anda. SDKTidak memvalidasi batas ini, dan kesalahan runtime terjadi jika batas terlampaui.

Nilai Kuota Catatan
Jumlah aliran maks 128 Jumlah maksimum aliran yang dapat dibuat oleh objek produser. Ini adalah batas lunak (Anda dapat meminta kenaikan). Ini menjamin bahwa produsen tidak secara tidak sengaja membuat aliran secara rekursif.
Panjang nama perangkat maks 128 karakter  
Jumlah tag maks 50 per aliran  
Panjang nama aliran maks 256 karakter  
Ukuran penyimpanan min 10 MiB = 10 * 1024 * 1024 byte  
Ukuran penyimpanan maks 10 GiB = 10 * 1024 * 1024 * 1024 byte  
Panjang jalur direktori root maks 4.096 karakter  
Panjang info autentikasi maks 10.000 byte  
Panjang URI string maks 10.000 karakter  
Panjang nama tag maks 128 karakter  
Panjang nilai tag maks 1.024 karakter  
Periode token keamanan min 30 detik  
Masa tenggang token keamanan 40 menit Jika durasi yang ditentukan lebih lama, itu terbatas pada nilai ini.
Periode penahanan 0 atau lebih dari satu jam 0 menunjukkan tidak ada retensi.
Durasi cluster min 1 detik Nilai ditentukan dalam 100 ns unit, yang merupakan SDK standar.
Durasi cluster maks 30 detik Nilai ditentukan dalam 100 ns unit, yang merupakan SDK standar. Backend API dapat menerapkan durasi cluster yang lebih pendek.
Ukuran fragmen maks 50 MB Untuk informasi selengkapnya, lihat Kuota layanan Amazon Kinesis Video Streams.
Durasi fragmen maks 20 detik Untuk informasi selengkapnya, lihat Kuota layanan Amazon Kinesis Video Streams.
Durasi koneksi maks 45 menit Backend menutup koneksi setelah waktu ini. SDKMemutar token dan membuat koneksi baru dalam waktu ini.
Panjang ACK segmen maks 1.024 karakter Panjang segmen maksimum dari pengakuan yang dikirim ke fungsi ACK parser.
Panjang string tipe konten maks 128 karakter  
Panjang string ID codec maks 32 karakter  
Panjang string nama trek maks 32 karakter  
Panjang data pribadi codec maks 1 MiB = 1 * 1024 * 1024 byte  
Panjang nilai skala kode waktu min 100 ns Nilai skala kode waktu minimum untuk mewakili stempel waktu bingkai di cluster yang dihasilkan. MKV Nilai ditentukan dalam penambahan 100 ns, yang merupakan SDK standar.
Panjang nilai skala kode waktu maks 1 detik Nilai skala timecode maksimum untuk mewakili stempel waktu bingkai di cluster yang dihasilkan. MKV Nilai ditentukan dalam penambahan 100 ns, yang merupakan SDK standar.
Jumlah item tampilan konten min 10  
Durasi buffer min 20 detik Nilai ditentukan dalam penambahan 100 ns, yang merupakan SDK standar.
Panjang versi pembaruan maks 128 karakter  
ARNPanjang maks 1024 karakter  
Panjang urutan fragmen maks 128 karakter  
Periode retensi maks 10 tahun