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](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html) sebagai gantinya. 

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

# StartMigration
<a name="API_StartMigration"></a>

Mulai memigrasikan bot dari Amazon Lex V1 ke Amazon Lex V2. Migrasikan bot Anda saat Anda ingin memanfaatkan fitur baru Amazon Lex V2.

Untuk informasi selengkapnya, lihat [Memigrasi bot](https://docs.aws.amazon.com/lex/latest/dg/migrate.html) di *panduan pengembang Amazon Lex*.

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

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

{
   "migrationStrategy": "string",
   "v1BotName": "string",
   "v1BotVersion": "string",
   "v2BotName": "string",
   "v2BotRole": "string"
}
```

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

Permintaan tidak menggunakan parameter URI apa pun.

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

Permintaan menerima data berikut dalam format JSON.

 ** [migrationStrategy](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-migrationStrategy"></a>
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](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v1BotName"></a>
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](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v1BotVersion"></a>
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](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v2BotName"></a>
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](#API_StartMigration_RequestSyntax) **   <a name="lex-StartMigration-request-v2BotRole"></a>
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
<a name="API_StartMigration_ResponseSyntax"></a>

```
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
<a name="API_StartMigration_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 202.

Layanan mengembalikan data berikut dalam format JSON.

 ** [migrationId](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationId"></a>
Pengidentifikasi unik yang ditetapkan Amazon Lex untuk migrasi.  
Tipe: String  
Kendala Panjang: Panjang tetap 10.  
Pola: `^[0-9a-zA-Z]+$` 

 ** [migrationStrategy](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationStrategy"></a>
Strategi yang digunakan untuk melakukan migrasi.  
Tipe: String  
Nilai yang Valid: `CREATE_NEW | UPDATE_EXISTING` 

 ** [migrationTimestamp](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-migrationTimestamp"></a>
Tanggal dan waktu migrasi dimulai.  
Tipe: Timestamp

 ** [v1BotLocale](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v1BotLocale"></a>
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](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v1BotName"></a>
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](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v1BotVersion"></a>
Versi bot untuk bermigrasi ke Amazon Lex V2.   
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.  
Pola: `\$LATEST|[0-9]+` 

 ** [v2BotId](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v2BotId"></a>
Pengidentifikasi unik untuk bot Amazon Lex V2.   
Tipe: String  
Kendala Panjang: Panjang tetap 10.  
Pola: `^[0-9a-zA-Z]+$` 

 ** [v2BotRole](#API_StartMigration_ResponseSyntax) **   <a name="lex-StartMigration-response-v2BotRole"></a>
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
<a name="API_StartMigration_Errors"></a>

 ** 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
<a name="API_StartMigration_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/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/StartMigration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/StartMigration)