

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.

# CreateIntentVersion
<a name="API_CreateIntentVersion"></a>

Membuat versi baru dari intent berdasarkan `$LATEST` versi intent. Jika `$LATEST` versi intent ini tidak berubah sejak terakhir kali Anda memperbaruinya, Amazon Lex tidak membuat versi baru. Ini mengembalikan versi terakhir yang Anda buat.

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

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

Operasi ini memerlukan izin untuk menjalankan tindakan `lex:CreateIntentVersion`. 

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

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

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

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

Permintaan menggunakan parameter URI berikut.

 ** [name](#API_CreateIntentVersion_RequestSyntax) **   <a name="lex-CreateIntentVersion-request-uri-name"></a>
Nama maksud yang ingin Anda buat versi baru. Namanya peka huruf besar/kecil.   
Batasan Panjang: Panjang minimum 1. Panjang maksimum 100.  
Pola: `^([A-Za-z]_?)+$`   
Wajib: Ya

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

Permintaan menerima data berikut dalam format JSON.

 ** [checksum](#API_CreateIntentVersion_RequestSyntax) **   <a name="lex-CreateIntentVersion-request-checksum"></a>
Checksum `$LATEST` versi intent yang harus digunakan untuk membuat versi baru. Jika Anda menentukan checksum dan `$LATEST` versi intent memiliki checksum yang berbeda, Amazon Lex mengembalikan `PreconditionFailedException` pengecualian dan tidak memublikasikan versi baru. Jika Anda tidak menentukan checksum, Amazon Lex menerbitkan versinya. `$LATEST`  
Tipe: String  
Wajib: Tidak

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

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

{
   "checksum": "string",
   "conclusionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "confirmationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createdDate": number,
   "description": "string",
   "dialogCodeHook": { 
      "messageVersion": "string",
      "uri": "string"
   },
   "followUpPrompt": { 
      "prompt": { 
         "maxAttempts": number,
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      },
      "rejectionStatement": { 
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      }
   },
   "fulfillmentActivity": { 
      "codeHook": { 
         "messageVersion": "string",
         "uri": "string"
      },
      "type": "string"
   },
   "inputContexts": [ 
      { 
         "name": "string"
      }
   ],
   "kendraConfiguration": { 
      "kendraIndex": "string",
      "queryFilterString": "string",
      "role": "string"
   },
   "lastUpdatedDate": number,
   "name": "string",
   "outputContexts": [ 
      { 
         "name": "string",
         "timeToLiveInSeconds": number,
         "turnsToLive": number
      }
   ],
   "parentIntentSignature": "string",
   "rejectionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "sampleUtterances": [ "string" ],
   "slots": [ 
      { 
         "defaultValueSpec": { 
            "defaultValueList": [ 
               { 
                  "defaultValue": "string"
               }
            ]
         },
         "description": "string",
         "name": "string",
         "obfuscationSetting": "string",
         "priority": number,
         "responseCard": "string",
         "sampleUtterances": [ "string" ],
         "slotConstraint": "string",
         "slotType": "string",
         "slotTypeVersion": "string",
         "valueElicitationPrompt": { 
            "maxAttempts": number,
            "messages": [ 
               { 
                  "content": "string",
                  "contentType": "string",
                  "groupNumber": number
               }
            ],
            "responseCard": "string"
         }
      }
   ],
   "version": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respon HTTP 201.

Layanan mengembalikan data berikut dalam format JSON.

 ** [checksum](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-checksum"></a>
Checksum dari versi maksud yang dibuat.  
Tipe: String

 ** [conclusionStatement](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-conclusionStatement"></a>
Setelah fungsi Lambda yang ditentukan dalam `fulfillmentActivity` bidang memenuhi maksud, Amazon Lex menyampaikan pernyataan ini kepada pengguna.   
Tipe: Objek [Statement](API_Statement.md)

 ** [confirmationPrompt](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-confirmationPrompt"></a>
Jika ditentukan, prompt yang digunakan Amazon Lex untuk mengonfirmasi maksud pengguna sebelum memenuhinya.   
Tipe: Objek [Prompt](API_Prompt.md)

 ** [createdDate](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-createdDate"></a>
Tanggal niat dibuat.  
Tipe: Timestamp

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

 ** [dialogCodeHook](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-dialogCodeHook"></a>
Jika ditentukan, Amazon Lex memanggil fungsi Lambda ini untuk setiap input pengguna.  
Tipe: Objek [CodeHook](API_CodeHook.md)

 ** [followUpPrompt](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-followUpPrompt"></a>
Jika didefinisikan, Amazon Lex menggunakan prompt ini untuk meminta aktivitas pengguna tambahan setelah intent terpenuhi.   
Tipe: Objek [FollowUpPrompt](API_FollowUpPrompt.md)

 ** [fulfillmentActivity](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-fulfillmentActivity"></a>
 Menjelaskan bagaimana niat terpenuhi.   
Tipe: Objek [FulfillmentActivity](API_FulfillmentActivity.md)

 ** [inputContexts](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-inputContexts"></a>
Larik `InputContext` objek yang mencantumkan konteks yang harus aktif untuk Amazon Lex untuk memilih maksud dalam percakapan dengan pengguna.  
Tipe: Array objek [InputContext](API_InputContext.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 5 item.

 ** [kendraConfiguration](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-kendraConfiguration"></a>
Informasi konfigurasi, jika ada, untuk menghubungkan indeks Amazon Kendra dengan maksud. `AMAZON.KendraSearchIntent`  
Tipe: Objek [KendraConfiguration](API_KendraConfiguration.md)

 ** [lastUpdatedDate](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-lastUpdatedDate"></a>
Tanggal niat diperbarui.   
Tipe: Timestamp

 ** [name](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-name"></a>
Nama niat.  
Tipe: String  
Panjang Batasan: Panjang minimum 1. Panjang maksimum 100.  
Pola: `^([A-Za-z]_?)+$` 

 ** [outputContexts](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-outputContexts"></a>
Array `OutputContext` objek yang mencantumkan konteks yang mengaktifkan intent saat intent terpenuhi.  
Tipe: Array objek [OutputContext](API_OutputContext.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 10 item.

 ** [parentIntentSignature](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-parentIntentSignature"></a>
Pengidentifikasi unik untuk maksud bawaan.  
Tipe: String

 ** [rejectionStatement](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-rejectionStatement"></a>
Jika pengguna menjawab “tidak” untuk pertanyaan yang didefinisikan dalam`confirmationPrompt`, Amazon Lex merespons dengan pernyataan ini untuk mengakui bahwa maksud tersebut dibatalkan.   
Tipe: Objek [Statement](API_Statement.md)

 ** [sampleUtterances](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-sampleUtterances"></a>
Larik contoh ucapan yang dikonfigurasi untuk maksud.   
Tipe: Array string  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 1500 item.  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 200.

 ** [slots](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-slots"></a>
Array jenis slot yang mendefinisikan informasi yang diperlukan untuk memenuhi maksud.  
Tipe: Array objek [Slot](API_Slot.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 100 item.

 ** [version](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-version"></a>
Nomor versi yang ditetapkan ke versi baru dari intent.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.  
Pola: `\$LATEST|[0-9]+` 

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