UpdateStream - Amazon Kinesis Video Streams
Minta SintaksParameter Permintaan URIIsi PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

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

UpdateStream

Memperbarui metadata aliran, seperti nama perangkat dan jenis media.

Anda harus memberikan nama streaming atau Nama Sumber Daya Amazon (ARN) aliran.

Untuk memastikan bahwa Anda memiliki versi streaming terbaru sebelum memperbaruinya, Anda dapat menentukan versi streaming. Kinesis Video Streams menetapkan versi untuk setiap aliran. Saat Anda memperbarui streaming, Kinesis Video Streams menetapkan nomor versi baru. Untuk mendapatkan versi streaming terbaru, gunakan DescribeStream API.

UpdateStreamadalah operasi asinkron, dan membutuhkan waktu untuk menyelesaikannya.

Minta Sintaks

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

{
   "CurrentVersion": "string",
   "DeviceName": "string",
   "MediaType": "string",
   "StreamARN": "string",
   "StreamName": "string"
}

Parameter Permintaan URI

Permintaan tidak menggunakan parameter URI apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

CurrentVersion

Versi aliran yang metadatanya ingin Anda perbarui.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.

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

Wajib: Ya

DeviceName

Nama perangkat yang menulis ke aliran.

catatan

Dalam implementasi saat ini, Kinesis Video Streams tidak menggunakan nama ini.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.

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

Wajib: Tidak

MediaType

Jenis media streaming. Gunakan MediaType untuk menentukan jenis konten yang dikandung aliran ke konsumen aliran. Untuk informasi selengkapnya tentang jenis media, lihat Jenis Media. Jika Anda memilih untuk menentukanMediaType, lihat Persyaratan Penamaan.

Untuk memutar video di konsol, Anda harus menentukan jenis video yang benar. Misalnya, jika video dalam aliran adalah H.264, tentukan video/h264 sebagai. MediaType

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.

Pola: [\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*

Wajib: Tidak

StreamARN

ARN dari aliran yang metadatanya ingin Anda perbarui.

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 yang metadatanya ingin Anda perbarui.

Nama aliran adalah pengenal untuk aliran, dan harus unik untuk setiap akun dan wilayah.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.

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

Diperlukan: Tidak

Sintaksis Respons

HTTP/1.1 200

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

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 panggilan klien yang diizinkan. Coba buat panggilan nanti.

Kode Status HTTP: 400

InvalidArgumentException

Nilai untuk parameter input ini tidak valid.

Kode Status HTTP: 400

NotAuthorizedException

Penelepon tidak berwenang untuk melakukan operasi ini.

Kode Status HTTP: 401

ResourceInUseException

Ketika input StreamARN atau ChannelARN in sudah CLOUD_STORAGE_MODE dipetakan ke sumber Kinesis Video Stream yang berbeda, atau jika StreamARN input ChannelARN yang disediakan atau tidak dalam status Aktif, coba salah satu dari berikut ini:

  1. DescribeMediaStorageConfigurationAPI untuk menentukan saluran aliran yang diberikan dipetakan.

  2. DescribeMappedResourceConfigurationAPI untuk menentukan saluran tempat aliran yang diberikan dipetakan.

  3. DescribeSignalingChannelAPI DescribeStream atau untuk menentukan status sumber daya.

Kode Status HTTP: 400

ResourceNotFoundException

Amazon Kinesis Video Streams tidak dapat menemukan aliran yang Anda tentukan.

Kode Status HTTP: 404

VersionMismatchException

Versi streaming yang Anda tentukan bukan versi terbaru. Untuk mendapatkan versi terbaru, gunakan DescribeStreamAPI.

Kode Status HTTP: 400

Lihat Juga

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