Pemberitahuan akhir dukungan: Pada 15 September 2025, AWS akan menghentikan dukungan untuk Amazon Lex V1. Setelah 15 September 2025, Anda tidak lagi dapat mengakses konsol Amazon Lex V1 atau sumber daya Amazon Lex V1. Jika Anda menggunakan Amazon Lex V2, lihat panduan Amazon Lex V2 sebagai gantinya.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Mulai memigrasikan bot dari Amazon Lex V1 ke Amazon Lex V2. Migrasikan bot Anda saat Anda ingin memanfaatkan fitur-fitur baru Amazon Lex V2.
Untuk informasi selengkapnya, lihat Memigrasi bot di panduan pengembang Amazon Lex.
Minta Sintaks
POST /migrations HTTP/1.1
Content-type: application/json
{
"migrationStrategy": "string
",
"v1BotName": "string
",
"v1BotVersion": "string
",
"v2BotName": "string
",
"v2BotRole": "string
"
}
Parameter Permintaan URI
Permintaan tidak menggunakan parameter URI apa pun.
Isi Permintaan
Permintaan menerima data berikut dalam format JSON.
- migrationStrategy
-
Strategi yang digunakan untuk melakukan migrasi.
-
CREATE_NEW
- Membuat bot Amazon Lex V2 baru dan memigrasikan bot Amazon Lex V1 ke bot baru. -
UPDATE_EXISTING
- Menimpa metadata bot Amazon Lex V2 yang ada dan lokal yang sedang dimigrasikan. Itu tidak mengubah lokal lain di bot Amazon Lex V2. Jika lokal tidak ada, lokal baru dibuat di bot Amazon Lex V2.
Tipe: String
Nilai yang Valid:
CREATE_NEW | UPDATE_EXISTING
Wajib: Ya
-
- v1BotName
-
Nama bot Amazon Lex V1 yang Anda migrasikan ke Amazon Lex V2.
Tipe: String
Kendala Panjang: Panjang minimum 2. Panjang maksimum 50.
Pola:
^([A-Za-z]_?)+$
Wajib: Ya
- v1BotVersion
-
Versi bot untuk bermigrasi ke Amazon Lex V2. Anda dapat memigrasikan
$LATEST
versi serta versi bernomor apa pun.Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Pola:
\$LATEST|[0-9]+
Wajib: Ya
- v2BotName
-
Nama bot Amazon Lex V2 tempat Anda memigrasikan bot Amazon Lex V1.
-
Jika bot Amazon Lex V2 tidak ada, Anda harus menggunakan strategi
CREATE_NEW
migrasi. -
Jika bot Amazon Lex V2 ada, Anda harus menggunakan strategi
UPDATE_EXISTING
migrasi untuk mengubah konten bot Amazon Lex V2.
Tipe: String
Panjang Batasan: Panjang minimum 1. Panjang maksimum 100.
Pola:
^([0-9a-zA-Z][_-]?)+$
Wajib: Ya
-
- v2BotRole
-
Peran IAM yang digunakan Amazon Lex untuk menjalankan bot Amazon Lex V2.
Tipe: String
Batasan Panjang: Panjang minimum 20. Panjang maksimum 2048.
Pola:
^arn:[\w\-]+:iam::[\d]{12}:role/.+$
Diperlukan: Ya
Sintaksis Respons
HTTP/1.1 202
Content-type: application/json
{
"migrationId": "string",
"migrationStrategy": "string",
"migrationTimestamp": number,
"v1BotLocale": "string",
"v1BotName": "string",
"v1BotVersion": "string",
"v2BotId": "string",
"v2BotRole": "string"
}
Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 202.
Layanan mengembalikan data berikut dalam format JSON.
- migrationId
-
Pengenal unik yang ditetapkan Amazon Lex untuk migrasi.
Tipe: String
Kendala Panjang: Panjang tetap 10.
Pola:
^[0-9a-zA-Z]+$
- migrationStrategy
-
Strategi yang digunakan untuk melakukan migrasi.
Tipe: String
Nilai yang Valid:
CREATE_NEW | UPDATE_EXISTING
- migrationTimestamp
-
Tanggal dan waktu migrasi dimulai.
Tipe: Timestamp
- v1BotLocale
-
Lokal yang digunakan untuk bot Amazon Lex V1.
Tipe: String
Nilai yang Valid:
de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR
- v1BotName
-
Nama bot Amazon Lex V1 yang Anda migrasikan ke Amazon Lex V2.
Tipe: String
Kendala Panjang: Panjang minimum 2. Panjang maksimum 50.
Pola:
^([A-Za-z]_?)+$
- v1BotVersion
-
Versi bot untuk bermigrasi ke Amazon Lex V2.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Pola:
\$LATEST|[0-9]+
- v2BotId
-
Pengidentifikasi unik untuk bot Amazon Lex V2.
Tipe: String
Kendala Panjang: Panjang tetap 10.
Pola:
^[0-9a-zA-Z]+$
- v2BotRole
-
Peran IAM yang digunakan Amazon Lex untuk menjalankan bot Amazon Lex V2.
Tipe: String
Batasan Panjang: Panjang minimum 20. Panjang maksimum 2048.
Pola:
^arn:[\w\-]+:iam::[\d]{12}:role/.+$
Kesalahan
- AccessDeniedException
-
Pengguna atau peran IAM Anda tidak memiliki izin untuk memanggil Amazon Lex V2 yang APIs diperlukan untuk memigrasi bot Anda.
Kode Status HTTP: 403
- 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
- NotFoundException
-
Sumber daya yang ditentukan dalam permintaan tidak ditemukan. Periksa sumber daya dan coba lagi.
Kode Status HTTP: 404
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini: