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

StartEdgeConfigurationUpdate

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 keSYNCING. Anda harus menunggu status sinkronisasi mencapai status terminal seperti:IN_SYNC, atauSYNC_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 untuk menghapus konfigurasi tepi saat ini. Anda kemudian dapat memanggil StartEdgeConfigurationUpdate dengan ARN Perangkat Hub yang diperbarui.

Minta Sintaks

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

Permintaan tidak menggunakan parameter URI apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

Sintaksis Respons

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

Lihat Juga

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