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

# StartEdgeConfigurationUpdate
<a name="API_StartEdgeConfigurationUpdate"></a>

API asinkron yang memperbarui konfigurasi tepi aliran yang ada. Kinesis Video Stream akan menyinkronkan konfigurasi tepi aliran dengan komponen Edge Agent IoT IoT yang berjalan pada Perangkat Hub IoT, disiapkan di premis Anda. Waktu untuk menyinkronkan dapat bervariasi dan tergantung pada konektivitas Perangkat Hub. Ini `SyncStatus` akan diperbarui saat konfigurasi tepi diakui, dan disinkronkan dengan Agen Edge. 

Jika API ini dipanggil untuk pertama kalinya, konfigurasi edge baru akan dibuat untuk streaming, dan status sinkronisasi akan disetel ke`SYNCING`. Anda harus menunggu status sinkronisasi mencapai status terminal seperti:`IN_SYNC`, atau`SYNC_FAILED`, sebelum menggunakan API ini lagi. Jika Anda menjalankan API ini selama proses sinkronisasi, a `ResourceInUseException` akan dilemparkan. Konektivitas konfigurasi tepi aliran dan Agen Edge akan dicoba lagi selama 15 menit. Setelah 15 menit, status akan beralih ke `SYNC_FAILED` negara bagian.

Untuk memindahkan konfigurasi tepi dari satu perangkat ke perangkat lainnya, gunakan [DeleteEdgeConfiguration](API_DeleteEdgeConfiguration.md) untuk menghapus konfigurasi tepi saat ini. Anda kemudian dapat memanggil StartEdgeConfigurationUpdate dengan ARN Perangkat Hub yang diperbarui.

**catatan**  
API ini tidak tersedia di wilayah AWS Afrika (Cape Town), af-south-1.

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

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

{
   "EdgeConfig": { 
      "DeletionConfig": { 
         "DeleteAfterUpload": boolean,
         "EdgeRetentionInHours": number,
         "LocalSizeConfig": { 
            "MaxLocalMediaSizeInMB": number,
            "StrategyOnFullSize": "string"
         }
      },
      "HubDeviceArn": "string",
      "RecorderConfig": { 
         "MediaSourceConfig": { 
            "MediaUriSecretArn": "string",
            "MediaUriType": "string"
         },
         "ScheduleConfig": { 
            "DurationInSeconds": number,
            "ScheduleExpression": "string"
         }
      },
      "UploaderConfig": { 
         "ScheduleConfig": { 
            "DurationInSeconds": number,
            "ScheduleExpression": "string"
         }
      }
   },
   "StreamARN": "string",
   "StreamName": "string"
}
```

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

Permintaan tidak menggunakan parameter URI apa pun.

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

Permintaan menerima data berikut dalam format JSON.

 ** [EdgeConfig](#API_StartEdgeConfigurationUpdate_RequestSyntax) **   <a name="KinesisVideo-StartEdgeConfigurationUpdate-request-EdgeConfig"></a>
Detail konfigurasi tepi diperlukan untuk menjalankan proses pembaruan.  
Tipe: Objek [EdgeConfig](API_EdgeConfig.md)  
Wajib: Ya

 ** [StreamARN](#API_StartEdgeConfigurationUpdate_RequestSyntax) **   <a name="KinesisVideo-StartEdgeConfigurationUpdate-request-StreamARN"></a>
 Nama Sumber Daya Amazon (ARN) dari aliran. Tentukan salah satu `StreamName` atau`StreamARN`.  
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_StartEdgeConfigurationUpdate_RequestSyntax) **   <a name="KinesisVideo-StartEdgeConfigurationUpdate-request-StreamName"></a>
Nama aliran yang konfigurasi tepinya ingin Anda perbarui. Tentukan salah satu `StreamName` atau`StreamARN`.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.  
Pola: `[a-zA-Z0-9_.-]+`   
Diperlukan: Tidak

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

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "EdgeConfig": { 
      "DeletionConfig": { 
         "DeleteAfterUpload": boolean,
         "EdgeRetentionInHours": number,
         "LocalSizeConfig": { 
            "MaxLocalMediaSizeInMB": number,
            "StrategyOnFullSize": "string"
         }
      },
      "HubDeviceArn": "string",
      "RecorderConfig": { 
         "MediaSourceConfig": { 
            "MediaUriSecretArn": "string",
            "MediaUriType": "string"
         },
         "ScheduleConfig": { 
            "DurationInSeconds": number,
            "ScheduleExpression": "string"
         }
      },
      "UploaderConfig": { 
         "ScheduleConfig": { 
            "DurationInSeconds": number,
            "ScheduleExpression": "string"
         }
      }
   },
   "FailedStatusDetails": "string",
   "LastUpdatedTime": number,
   "StreamARN": "string",
   "StreamName": "string",
   "SyncStatus": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [CreationTime](#API_StartEdgeConfigurationUpdate_ResponseSyntax) **   <a name="KinesisVideo-StartEdgeConfigurationUpdate-response-CreationTime"></a>
Stempel waktu di mana konfigurasi tepi aliran pertama kali dibuat.  
Tipe: Timestamp

 ** [EdgeConfig](#API_StartEdgeConfigurationUpdate_ResponseSyntax) **   <a name="KinesisVideo-StartEdgeConfigurationUpdate-response-EdgeConfig"></a>
Deskripsi konfigurasi tepi aliran yang akan digunakan untuk menyinkronkan dengan komponen Edge Agent IoT Greengrass. Komponen Edge Agent akan berjalan pada pengaturan Perangkat IoT Hub di premis Anda.  
Tipe: Objek [EdgeConfig](API_EdgeConfig.md)

 ** [FailedStatusDetails](#API_StartEdgeConfigurationUpdate_ResponseSyntax) **   <a name="KinesisVideo-StartEdgeConfigurationUpdate-response-FailedStatusDetails"></a>
Deskripsi status kegagalan yang dihasilkan.  
Tipe: String

 ** [LastUpdatedTime](#API_StartEdgeConfigurationUpdate_ResponseSyntax) **   <a name="KinesisVideo-StartEdgeConfigurationUpdate-response-LastUpdatedTime"></a>
Stempel waktu di mana konfigurasi tepi aliran terakhir diperbarui.  
Tipe: Timestamp

 ** [StreamARN](#API_StartEdgeConfigurationUpdate_ResponseSyntax) **   <a name="KinesisVideo-StartEdgeConfigurationUpdate-response-StreamARN"></a>
Nama Sumber Daya Amazon (ARN) dari aliran.  
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]+` 

 ** [StreamName](#API_StartEdgeConfigurationUpdate_ResponseSyntax) **   <a name="KinesisVideo-StartEdgeConfigurationUpdate-response-StreamName"></a>
Nama aliran dari mana konfigurasi tepi diperbarui.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.  
Pola: `[a-zA-Z0-9_.-]+` 

 ** [SyncStatus](#API_StartEdgeConfigurationUpdate_ResponseSyntax) **   <a name="KinesisVideo-StartEdgeConfigurationUpdate-response-SyncStatus"></a>
 Status sinkronisasi saat ini dari konfigurasi tepi aliran. Saat Anda menjalankan API ini, status sinkronisasi akan disetel ke `SYNCING` status. Gunakan `DescribeEdgeConfiguration` API untuk mendapatkan status terbaru dari konfigurasi edge.  
Tipe: String  
Nilai yang Valid: `SYNCING | ACKNOWLEDGED | IN_SYNC | SYNC_FAILED | DELETING | DELETE_FAILED | DELETING_ACKNOWLEDGED` 

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

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Jenis Kesalahan Umum](CommonErrors.md).

 ** AccessDeniedException **   
Anda tidak memiliki izin yang diperlukan untuk melakukan operasi ini.  
Kode Status HTTP: 401

 ** 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

 ** NoDataRetentionException **   
Retensi data Stream dalam jam sama dengan nol.  
Kode Status HTTP: 400

 ** 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

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