StartImport - Amazon Lex V1

Jika Anda menggunakan Amazon Lex V2, lihat panduan Amazon Lex V2 sebagai gantinya.

 

Jika Anda menggunakan Amazon Lex V1, kami sarankan untuk meningkatkan bot Anda ke Amazon Lex V2. Kami tidak lagi menambahkan fitur baru ke V1 dan sangat menyarankan menggunakan V2 untuk semua bot baru.

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

StartImport

Memulai pekerjaan untuk mengimpor sumber daya ke Amazon Lex.

Minta Sintaks

POST /imports/ HTTP/1.1 Content-type: application/json { "mergeStrategy": "string", "payload": blob, "resourceType": "string", "tags": [ { "key": "string", "value": "string" } ] }

Parameter Permintaan URI

Permintaan tidak menggunakan parameter URI apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

mergeStrategy

Menentukan tindakan yang harus dilakukan StartImport operasi ketika ada sumber daya yang ada dengan nama yang sama.

  • FAIL_ON_CONFLICT - Operasi impor dihentikan pada konflik pertama antara sumber daya dalam file impor dan sumber daya yang ada. Nama sumber daya yang menyebabkan konflik ada di failureReason bidang respons terhadap GetImport operasi.

    OVERWRITE_LATEST - Operasi impor berlangsung bahkan jika ada konflik dengan sumber daya yang ada. Versi $LASTEST dari sumber daya yang ada ditimpa dengan data dari file impor.

Jenis: String

Nilai yang Valid: OVERWRITE_LATEST | FAIL_ON_CONFLICT

Diperlukan: Ya

payload

Arsip zip dalam format biner. Arsip harus berisi satu file, file JSON yang berisi sumber daya untuk diimpor. Sumber daya harus cocok dengan jenis yang ditentukan di resourceType bidang.

Tipe: Objek data biner dienkode Base64

Diperlukan: Ya

resourceType

Menentukan jenis sumber daya untuk mengekspor. Setiap sumber daya juga mengekspor sumber daya apa pun yang bergantung padanya.

  • Bot mengekspor maksud yang bergantung.

  • Maksud mengekspor jenis slot yang bergantung.

Jenis: String

Nilai yang Valid: BOT | INTENT | SLOT_TYPE

Diperlukan: Ya

tags

Daftar tag untuk ditambahkan ke bot yang diimpor. Anda hanya dapat menambahkan tag saat mengimpor bot, Anda tidak dapat menambahkan tag ke maksud atau jenis slot.

Tipe: Array objek Tag

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.

Diperlukan: Tidak

Sintaksis Respons

HTTP/1.1 201 Content-type: application/json { "createdDate": number, "importId": "string", "importStatus": "string", "mergeStrategy": "string", "name": "string", "resourceType": "string", "tags": [ { "key": "string", "value": "string" } ] }

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respon HTTP 201.

Layanan mengembalikan data berikut dalam format JSON.

createdDate

Stempel waktu untuk tanggal dan waktu pekerjaan impor diminta.

Tipe: Timestamp

importId

Pengidentifikasi untuk pekerjaan impor tertentu.

Jenis: String

importStatus

Status pekerjaan impor. Jika statusnyaFAILED, Anda bisa mendapatkan alasan kegagalan menggunakan GetImport operasi.

Jenis: String

Nilai yang Valid: IN_PROGRESS | COMPLETE | FAILED

mergeStrategy

Tindakan yang harus diambil ketika ada konflik penggabungan.

Jenis: String

Nilai yang Valid: OVERWRITE_LATEST | FAIL_ON_CONFLICT

name

Nama yang diberikan untuk pekerjaan impor.

Jenis: String

Panjang Batasan: Panjang minimum 1. Panjang maksimum 100.

Pola: [a-zA-Z_]+

resourceType

Jenis sumber daya untuk diimpor.

Jenis: String

Nilai yang Valid: BOT | INTENT | SLOT_TYPE

tags

Daftar tag yang ditambahkan ke bot yang diimpor.

Tipe: Array objek Tag

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.

Kesalahan

BadRequestException

Permintaan tidak terbentuk dengan baik. Misalnya, nilai tidak valid atau bidang wajib hilang. Periksa nilai bidang, dan coba lagi.

Kode Status HTTP: 400

InternalFailureException

Terjadi kesalahan internal Amazon Lex. Coba permintaan Anda lagi.

Kode Status HTTP: 500

LimitExceededException

Permintaan melebihi batas. Coba permintaan Anda lagi.

Kode Status HTTP: 429

Lihat Juga

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