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.
`UpdateStream`adalah 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](#API_UpdateStream_RequestSyntax) **
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](#API_UpdateStream_RequestSyntax) **
Nama perangkat yang menulis ke aliran.
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](#API_UpdateStream_RequestSyntax) **
Jenis media streaming. Gunakan `MediaType` untuk menentukan jenis konten yang dikandung aliran ke konsumen aliran. Untuk informasi selengkapnya tentang jenis media, lihat [Jenis Media](http://www.iana.org/assignments/media-types/media-types.xhtml). Jika Anda memilih untuk menentukan`MediaType`, lihat [Persyaratan Penamaan](https://tools.ietf.org/html/rfc6838#section-4.2).
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](#API_UpdateStream_RequestSyntax) **
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](#API_UpdateStream_RequestSyntax) **
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 [Jenis Kesalahan Umum](CommonErrors.md).
** 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. `DescribeMediaStorageConfiguration`API untuk menentukan saluran aliran yang diberikan dipetakan.
1. `DescribeMappedResourceConfiguration`API untuk menentukan saluran tempat aliran yang diberikan dipetakan.
1. `DescribeSignalingChannel`API `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 [DescribeStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DescribeStream.html)API.
Kode Status HTTP: 400
## Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+ [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/UpdateStream)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/UpdateStream)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/UpdateStream)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/UpdateStream)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/UpdateStream)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/UpdateStream)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/UpdateStream)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/UpdateStream)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/UpdateStream)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/UpdateStream)