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 terhadapGetImport
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
-
-
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 statusnya
FAILED
, Anda bisa mendapatkan alasan kegagalan menggunakanGetImport
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
-
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: