View a markdown version of this page

Kuota layanan Amazon Kinesis Video Streams - Amazon Kinesis Video Streams
Kuota layanan API bidang kontrolKuota layanan API media dan media arsipFragment-metadata dan kuota fragmen-mediaKuota layanan metadata streamingKuota SDK 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.

Kuota layanan API bidang kontrol

Bagian berikut menjelaskan kuota layanan untuk API bidang kontrol. TPS adalah singkatan dari transaksi per detik.

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

API Batas akun: Permintaan Batas akun: Streams Stream-level batasi 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 Konsol Manajemen AWS at https://console.aws.amazon.com/ dan minta peningkatan batas ini.

Perangkat, CLI, SDK-driven akses, dan konsol semuanya dapat menjalankan API ini. Hanya satu panggilan API 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]
UpdateStreamStorageConfiguration 50 TPS [h] N/A 5 TPS [h]
DescribeStreamStorageConfiguration 50 TPS [h] N/A 5 TPS [h]

Kuota layanan API media dan media arsip

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

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 layanan API bidang data

API Stream-level batasi Connection-level batasi Batas bandwidth Fragment-level batasi Pengecualian dan catatan yang relevan
PutMedia 5 TPS [h] 1 [h] 12,5 MB/second, 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 streaming, koneksi yang berjalan lama. Anda tidak perlu membuka koneksi baru untuk setiap bagian data karena Anda dapat mengirim beberapa fragmen dalam satu koneksi persisten. Jika Anda mencoba lebih dari satu PutMedia koneksi bersamaan, Kinesis Video Streams membatasi koneksi terbaru dengan pesan kesalahan. ConnectionLimitExceededException
GetClip N/A N/A Batas ukuran 100 MB [h] Jumlah fragmen maksimum: 200 [h]
GetDASHStreamingSessionURL 25 TPS [h] N/A N/A N/A
GetHLSStreamingSessionURL 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 [h] 25 MB/s atau 200 Mbps [s] Maksimal 5 fragmen yang dikirim per detik [h] GetMediapermintaan streaming, koneksi yang berjalan lama. Anda tidak perlu membuka koneksi baru untuk setiap bagian data karena Anda dapat mengirim beberapa fragmen dalam satu koneksi persisten. Jika Anda mencoba lebih dari tiga GetMedia koneksi bersamaan, Kinesis Video Streams membatasi koneksi terbaru dengan pesan kesalahan. ConnectionLimitExceededException

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

catatan

GetMediatidak digunakan untuk HLS/DASH 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 layanan API protokol pemutaran video

API Session-level batasi Fragment-level batasi
GetDASHManifestPlaylist 5 TPS [h] Jumlah maksimum fragmen per daftar putar: 5.000 [h]
GetHLSMasterPlaylist 5 TPS [h] N/A
GetHLSMediaPlaylist 5 TPS [h] Jumlah maksimum fragmen per daftar putar: 5.000 [h]
GetMP4InitFragment 5 TPS [h] N/A
GetMP4MediaFragment 20 TPS [h] N/A
GettsFragment 20 TPS [h] N/A

Fragment-metadata dan kuota fragmen-media

API Kinesis Video Streams untuk mengakses media yang diarsipkan dibatasi berdasarkan jumlah fragmen yang diminta, bukan jumlah panggilan API. API dibatasi 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 beberapa API. Ini berarti bahwa, untuk aliran tertentu, permintaan fragmen di berbagai API menggunakan dari kuota yang sama. Ketika metadata fragmen atau kuota media fragmen untuk aliran terlampaui, API akan mengembalikan file. ClientLimitExceededException Tabel berikut menunjukkan bagaimana API mengkonsumsi dari masing-masing dari dua jenis kuota. Untuk kolom kedua dalam tabel ini, asumsikan bahwa jika aliran memiliki kuota N, itu berarti API memiliki titik N untuk dikonsumsi dari jenis kuota tersebut untuk aliran tersebut. GetClipAPI muncul di kedua tabel.

Fragment-metadata konsumsi kuota

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

Fragment-media konsumsi kuota

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 sesi HLS dan DASH 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 dengan 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: On-demand pemutaran

Dalam skenario pemutaran sesuai permintaan dari acara 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 (PIC tidak menambahkan item metadata), atau menanggapi kesalahan.

Kuota SDK produsen

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

catatan

Sebelum menetapkan nilai-nilai ini, Anda harus memvalidasi input Anda. SDK tidak 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 string URI 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 retensi 0 atau lebih dari satu jam 0 menunjukkan tidak ada retensi.
Durasi cluster min 1 detik Nilai ditentukan dalam unit 100 ns, yang merupakan standar SDK.
Durasi cluster maks 30 detik Nilai ditentukan dalam unit 100 ns, yang merupakan standar SDK. API backend 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. SDK memutar token dan membuat koneksi baru dalam waktu ini.
Panjang segmen ACK maks 1.024 karakter Panjang segmen maksimum dari pengakuan yang dikirim ke fungsi parser ACK.
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 MKV yang dihasilkan. Nilai ditentukan dalam penambahan 100 ns, yang merupakan standar SDK.
Panjang nilai skala kode waktu maks 1 detik Nilai skala timecode maksimum untuk mewakili stempel waktu bingkai di cluster MKV yang dihasilkan. Nilai ditentukan dalam penambahan 100 ns, yang merupakan standar SDK.
Jumlah item tampilan konten min 10  
Durasi buffer min 20 detik Nilai ditentukan dalam penambahan 100 ns, yang merupakan standar SDK.
Panjang versi pembaruan maks 128 karakter  
Panjang ARN maks 1024 karakter  
Panjang urutan fragmen maks 128 karakter  
Periode retensi maks 10 tahun