

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.

# CreateBotVersion
<a name="API_CreateBotVersion"></a>

Membuat versi baru bot berdasarkan `$LATEST` versi. Jika `$LATEST` versi sumber daya ini tidak berubah sejak Anda membuat versi terakhir, Amazon Lex tidak membuat versi baru. Ia mengembalikan versi yang terakhir dibuat.

**catatan**  
Anda hanya dapat memperbarui `$LATEST` versi bot. Anda tidak dapat memperbarui versi bernomor yang Anda buat dengan `CreateBotVersion` operasi.

 Saat Anda membuat versi pertama bot, Amazon Lex menetapkan versi ke 1. Versi selanjutnya meningkat sebesar 1. Untuk informasi selengkapnya, lihat [Penentuan versi](versioning-aliases.md#versioning-intro). 

 Operasi ini memerlukan izin untuk tindakan `lex:CreateBotVersion`. 

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

```
POST /bots/name/versions HTTP/1.1
Content-type: application/json

{
   "checksum": "string"
}
```

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

Permintaan menggunakan parameter URI berikut.

 ** [name](#API_CreateBotVersion_RequestSyntax) **   <a name="lex-CreateBotVersion-request-uri-name"></a>
Nama bot yang ingin Anda buat versi baru. Namanya peka huruf besar/kecil.   
Kendala Panjang: Panjang minimum 2. Panjang maksimum 50.  
Pola: `^([A-Za-z]_?)+$`   
Wajib: Ya

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

Permintaan menerima data berikut dalam format JSON.

 ** [checksum](#API_CreateBotVersion_RequestSyntax) **   <a name="lex-CreateBotVersion-request-checksum"></a>
Mengidentifikasi revisi spesifik dari `$LATEST` versi bot. Jika Anda menentukan checksum dan `$LATEST` versi bot memiliki checksum yang berbeda, `PreconditionFailedException` pengecualian akan dikembalikan dan Amazon Lex tidak menerbitkan versi baru. Jika Anda tidak menentukan checksum, Amazon Lex menerbitkan versinya. `$LATEST`  
Tipe: String  
Wajib: Tidak

## Sintaksis Respons
<a name="API_CreateBotVersion_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "abortStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "checksum": "string",
   "childDirected": boolean,
   "clarificationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createdDate": number,
   "description": "string",
   "detectSentiment": boolean,
   "enableModelImprovements": boolean,
   "failureReason": "string",
   "idleSessionTTLInSeconds": number,
   "intents": [ 
      { 
         "intentName": "string",
         "intentVersion": "string"
      }
   ],
   "lastUpdatedDate": number,
   "locale": "string",
   "name": "string",
   "status": "string",
   "version": "string",
   "voiceId": "string"
}
```

## Elemen Respons
<a name="API_CreateBotVersion_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respon HTTP 201.

Layanan mengembalikan data berikut dalam format JSON.

 ** [abortStatement](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-abortStatement"></a>
Pesan yang digunakan Amazon Lex untuk membatalkan percakapan. Untuk informasi selengkapnya, lihat [PutBot](API_PutBot.md).  
Tipe: Objek [Statement](API_Statement.md)

 ** [checksum](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-checksum"></a>
Checksum mengidentifikasi versi bot yang dibuat.  
Tipe: String

 ** [childDirected](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-childDirected"></a>
Untuk setiap bot Amazon Lex yang dibuat dengan Layanan Pembuatan Model Amazon Lex, Anda harus menentukan apakah penggunaan Amazon Lex Anda terkait dengan situs web, program, atau aplikasi lain yang diarahkan atau ditargetkan, secara keseluruhan atau sebagian, untuk anak-anak di bawah usia 13 tahun dan tunduk pada Undang-Undang Perlindungan Privasi Online Anak (COPPA) dengan menentukan `true` atau `false` di lapangan. `childDirected` **Dengan menentukan `true` di `childDirected` lapangan, Anda mengonfirmasi bahwa penggunaan Amazon Lex Anda terkait dengan situs web, program, atau aplikasi lain yang diarahkan atau ditargetkan, secara keseluruhan atau sebagian, untuk anak-anak di bawah usia 13 tahun dan tunduk pada COPPA.** Dengan menentukan `false` di `childDirected` lapangan, Anda mengonfirmasi bahwa penggunaan Amazon Lex Anda **tidak** terkait dengan situs web, program, atau aplikasi lain yang diarahkan atau ditargetkan, secara keseluruhan atau sebagian, untuk anak-anak di bawah usia 13 tahun dan tunduk pada COPPA. Anda tidak boleh menentukan nilai default untuk `childDirected` bidang yang tidak secara akurat mencerminkan apakah penggunaan Amazon Lex Anda terkait dengan situs web, program, atau aplikasi lain yang diarahkan atau ditargetkan, secara keseluruhan atau sebagian, untuk anak-anak di bawah usia 13 tahun dan tunduk pada COPPA.  
Jika penggunaan Amazon Lex Anda terkait dengan situs web, program, atau aplikasi lain yang diarahkan secara keseluruhan atau sebagian, untuk anak-anak di bawah usia 13 tahun, Anda harus mendapatkan persetujuan orang tua yang dapat diverifikasi berdasarkan COPPA. Untuk informasi mengenai penggunaan Amazon Lex sehubungan dengan situs web, program, atau aplikasi lain yang diarahkan atau ditargetkan, secara keseluruhan atau sebagian, untuk anak-anak di bawah usia 13 tahun, lihat [FAQ Amazon Lex](https://aws.amazon.com/lex/faqs#data-security).   
Jenis: Boolean

 ** [clarificationPrompt](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-clarificationPrompt"></a>
Pesan yang digunakan Amazon Lex saat tidak memahami permintaan pengguna. Untuk informasi selengkapnya, lihat [PutBot](API_PutBot.md).   
Tipe: Objek [Prompt](API_Prompt.md)

 ** [createdDate](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-createdDate"></a>
Tanggal ketika versi bot dibuat.  
Tipe: Timestamp

 ** [description](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-description"></a>
Deskripsi bot.  
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 200.

 ** [detectSentiment](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-detectSentiment"></a>
Menunjukkan apakah ucapan yang dimasukkan oleh pengguna harus dikirim ke Amazon Comprehend untuk analisis sentimen.  
Jenis: Boolean

 ** [enableModelImprovements](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-enableModelImprovements"></a>
Menunjukkan apakah bot menggunakan peningkatan akurasi. `true`menunjukkan bahwa bot menggunakan perbaikan, jika tidak,`false`.  
Jenis: Boolean

 ** [failureReason](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-failureReason"></a>
Jika `status` ya`FAILED`, Amazon Lex memberikan alasan bahwa ia gagal membangun bot.  
Tipe: String

 ** [idleSessionTTLInSeconds](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-idleSessionTTLInSeconds"></a>
Waktu maksimum dalam hitungan detik Amazon Lex menyimpan data yang dikumpulkan dalam percakapan. Untuk informasi selengkapnya, lihat [PutBot](API_PutBot.md).  
Jenis: Integer  
Rentang yang Valid: Nilai minimum 60. Nilai maksimum 86400.

 ** [intents](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-intents"></a>
Susunan objek `Intent`. Untuk informasi selengkapnya, lihat [PutBot](API_PutBot.md).  
Tipe: Array objek [Intent](API_Intent.md)

 ** [lastUpdatedDate](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-lastUpdatedDate"></a>
Tanggal ketika `$LATEST` versi bot ini diperbarui.   
Tipe: Timestamp

 ** [locale](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-locale"></a>
 Menentukan lokal target untuk bot.   
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` 

 ** [name](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-name"></a>
Nama bot.  
Tipe: String  
Kendala Panjang: Panjang minimum 2. Panjang maksimum 50.  
Pola: `^([A-Za-z]_?)+$` 

 ** [status](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-status"></a>
 Saat Anda mengirim permintaan untuk membuat atau memperbarui bot, Amazon Lex menyetel elemen `status` respons ke`BUILDING`. Setelah Amazon Lex membangun bot, itu ditetapkan `status` ke`READY`. Jika Amazon Lex tidak dapat membangun bot, itu akan diatur `status` ke`FAILED`. Amazon Lex mengembalikan alasan kegagalan elemen `failureReason` respons.   
Tipe: String  
Nilai yang Valid: `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT` 

 ** [version](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-version"></a>
Versi bot.   
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.  
Pola: `\$LATEST|[0-9]+` 

 ** [voiceId](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-voiceId"></a>
ID suara Amazon Polly yang digunakan Amazon Lex untuk interaksi suara dengan pengguna.  
Tipe: String

## Kesalahan
<a name="API_CreateBotVersion_Errors"></a>

 ** BadRequestException **   
Permintaan tidak terbentuk dengan baik. Misalnya, nilai tidak valid atau bidang wajib hilang. Periksa nilai bidang, dan coba lagi.  
Kode Status HTTP: 400

 ** ConflictException **   
 Ada konflik memproses permintaan. Coba permintaan Anda lagi.   
Kode Status HTTP: 409

 ** 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

 ** PreconditionFailedException **   
 Checksum sumber daya yang Anda coba ubah tidak cocok dengan checksum dalam permintaan. Periksa checksum sumber daya dan coba lagi.  
Kode Status HTTP: 412

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