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

# UpdateDataRetention
<a name="API_UpdateDataRetention"></a>

Meningkatkan atau mengurangi periode retensi data stream dengan nilai yang Anda tentukan. Untuk menunjukkan apakah Anda ingin menambah atau mengurangi periode retensi data, tentukan `Operation` parameter di badan permintaan. Dalam permintaan, Anda harus menentukan salah satu `StreamName` atau`StreamARN`. 

Operasi ini memerlukan izin untuk tindakan `KinesisVideo:UpdateDataRetention`.

Mengubah periode retensi data mempengaruhi data dalam aliran sebagai berikut:
+ Jika periode retensi data meningkat, data yang ada disimpan untuk periode retensi baru. Misalnya, jika periode retensi data ditingkatkan dari satu jam menjadi tujuh jam, semua data yang ada disimpan selama tujuh jam.
+ Jika periode retensi data menurun, data yang ada disimpan untuk periode retensi baru. Misalnya, jika periode retensi data berkurang dari tujuh jam menjadi satu jam, semua data yang ada disimpan selama satu jam, dan data yang lebih lama dari satu jam segera dihapus.

## Minta Sintaks
<a name="API_UpdateDataRetention_RequestSyntax"></a>

```
POST /updateDataRetention HTTP/1.1
Content-type: application/json

{
   "CurrentVersion": "string",
   "DataRetentionChangeInHours": number,
   "Operation": "string",
   "StreamARN": "string",
   "StreamName": "string"
}
```

## Parameter Permintaan URI
<a name="API_UpdateDataRetention_RequestParameters"></a>

Permintaan tidak menggunakan parameter URI apa pun.

## Isi Permintaan
<a name="API_UpdateDataRetention_RequestBody"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [CurrentVersion](#API_UpdateDataRetention_RequestSyntax) **   <a name="KinesisVideo-UpdateDataRetention-request-CurrentVersion"></a>
Versi aliran yang periode retensinya ingin Anda ubah. Untuk mendapatkan versinya, hubungi API `DescribeStream` atau `ListStreams` API.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.  
Pola: `[a-zA-Z0-9]+`   
Wajib: Ya

 ** [DataRetentionChangeInHours](#API_UpdateDataRetention_RequestSyntax) **   <a name="KinesisVideo-UpdateDataRetention-request-DataRetentionChangeInHours"></a>
Jumlah jam untuk menyesuaikan retensi saat ini oleh. Nilai yang Anda tentukan ditambahkan atau dikurangi dari nilai saat ini, tergantung pada nilai. `operation`  
Nilai minimum untuk retensi data adalah 0 dan nilai maksimum adalah 87600 (sepuluh tahun).  
Tipe: Bilangan Bulat  
Rentang yang Valid: Nilai minimum 1.  
Wajib: Ya

 ** [Operation](#API_UpdateDataRetention_RequestSyntax) **   <a name="KinesisVideo-UpdateDataRetention-request-Operation"></a>
Menunjukkan apakah Anda ingin menambah atau mengurangi periode retensi.  
Tipe: String  
Nilai yang Valid: `INCREASE_DATA_RETENTION | DECREASE_DATA_RETENTION`   
Wajib: Ya

 ** [StreamARN](#API_UpdateDataRetention_RequestSyntax) **   <a name="KinesisVideo-UpdateDataRetention-request-StreamARN"></a>
Nama Sumber Daya Amazon (ARN) dari aliran yang periode retensinya ingin Anda ubah.  
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_UpdateDataRetention_RequestSyntax) **   <a name="KinesisVideo-UpdateDataRetention-request-StreamName"></a>
Nama aliran yang periode retensinya ingin Anda ubah.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.  
Pola: `[a-zA-Z0-9_.-]+`   
Diperlukan: Tidak

## Sintaksis Respons
<a name="API_UpdateDataRetention_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elemen Respons
<a name="API_UpdateDataRetention_ResponseElements"></a>

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

## Kesalahan
<a name="API_UpdateDataRetention_Errors"></a>

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
<a name="API_UpdateDataRetention_SeeAlso"></a>

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/UpdateDataRetention) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/UpdateDataRetention) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/UpdateDataRetention) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/UpdateDataRetention) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/UpdateDataRetention) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/UpdateDataRetention) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/UpdateDataRetention) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/UpdateDataRetention) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/UpdateDataRetention) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/UpdateDataRetention)