Avviso di fine del supporto: il 15 settembre 2025 AWS interromperà il supporto per Amazon Lex V1. Dopo il 15 settembre 2025, non potrai più accedere alla console di Amazon Lex V1 o alle risorse di Amazon Lex V1. Se utilizzi Amazon Lex V2, consulta invece la [guida Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html). 

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Crea una nuova versione di un intento basata sulla `$LATEST` versione dell'intento. Se la `$LATEST` versione di questo intento non è cambiata dall'ultimo aggiornamento, Amazon Lex non crea una nuova versione. Restituisce l'ultima versione che hai creato.

**Nota**  
Puoi aggiornare solo la `$LATEST` versione dell'intento. Non è possibile aggiornare le versioni numerate create con l'`CreateIntentVersion`operazione.

 Quando crei una versione di un intento, Amazon Lex imposta la versione su 1. Le versioni successive aumentano di 1. Per ulteriori informazioni, consulta [Controllo delle versioni](versioning-aliases.md#versioning-intro). 

Questa operazione necessita delle autorizzazioni a eseguire l'operazione `lex:CreateIntentVersion`. 

## Sintassi della richiesta
<a name="API_CreateIntentVersion_RequestSyntax"></a>

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

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

## Parametri della richiesta URI
<a name="API_CreateIntentVersion_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_CreateIntentVersion_RequestSyntax) **   <a name="lex-CreateIntentVersion-request-uri-name"></a>
Il nome dell'intento di cui desideri creare una nuova versione. Il nome distingue tra maiuscole e minuscole.   
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_CreateIntentVersion_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [checksum](#API_CreateIntentVersion_RequestSyntax) **   <a name="lex-CreateIntentVersion-request-checksum"></a>
Checksum della `$LATEST` versione dell'intento da utilizzare per creare la nuova versione. Se specifichi un checksum e la `$LATEST` versione dell'intento ha un checksum diverso, Amazon Lex restituisce un'`PreconditionFailedException`eccezione e non pubblica una nuova versione. Se non specifichi un checksum, Amazon Lex pubblica la `$LATEST` versione.  
▬Tipo: stringa  
Obbligatorio: no

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_CreateIntentVersion_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 201.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [checksum](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-checksum"></a>
Checksum della versione dell'intento creata.  
Tipo: String

 ** [conclusionStatement](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-conclusionStatement"></a>
Dopo che la funzione Lambda specificata nel `fulfillmentActivity` campo soddisfa l'intento, Amazon Lex trasmette questa dichiarazione all'utente.   
Tipo: oggetto [Statement](API_Statement.md)

 ** [confirmationPrompt](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-confirmationPrompt"></a>
Se definito, il prompt utilizzato da Amazon Lex per confermare l'intenzione dell'utente prima di soddisfarla.   
Tipo: oggetto [Prompt](API_Prompt.md)

 ** [createdDate](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-createdDate"></a>
La data di creazione dell'intento.  
Tipo: Timestamp

 ** [description](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-description"></a>
Una descrizione dell'intento.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.

 ** [dialogCodeHook](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-dialogCodeHook"></a>
Se definita, Amazon Lex richiama questa funzione Lambda per ogni input dell'utente.  
Tipo: oggetto [CodeHook](API_CodeHook.md)

 ** [followUpPrompt](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-followUpPrompt"></a>
Se definito, Amazon Lex utilizza questo prompt per sollecitare ulteriori attività utente dopo il raggiungimento dell'intento.   
Tipo: oggetto [FollowUpPrompt](API_FollowUpPrompt.md)

 ** [fulfillmentActivity](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-fulfillmentActivity"></a>
 Descrive come viene soddisfatto l'intento.   
Tipo: oggetto [FulfillmentActivity](API_FulfillmentActivity.md)

 ** [inputContexts](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-inputContexts"></a>
Una serie di `InputContext` oggetti che elenca i contesti che devono essere attivi affinché Amazon Lex possa scegliere l'intento in una conversazione con l'utente.  
Tipo: matrice di oggetti [InputContext](API_InputContext.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo 5 elementi.

 ** [kendraConfiguration](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-kendraConfiguration"></a>
Informazioni di configurazione, se presenti, per connettere un indice Amazon Kendra con l'intento. `AMAZON.KendraSearchIntent`  
Tipo: oggetto [KendraConfiguration](API_KendraConfiguration.md)

 ** [lastUpdatedDate](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-lastUpdatedDate"></a>
La data in cui l'intento è stato aggiornato.   
Tipo: Timestamp

 ** [name](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-name"></a>
Il nome dell'intento.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `^([A-Za-z]_?)+$` 

 ** [outputContexts](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-outputContexts"></a>
Una matrice di `OutputContext` oggetti che elenca i contesti che l'intento attiva quando l'intento viene soddisfatto.  
Tipo: matrice di oggetti [OutputContext](API_OutputContext.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10 elementi.

 ** [parentIntentSignature](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-parentIntentSignature"></a>
Un identificatore univoco per un intento incorporato.  
Tipo: String

 ** [rejectionStatement](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-rejectionStatement"></a>
Se l'utente risponde «no» alla domanda definita in`confirmationPrompt`, Amazon Lex risponde con questa dichiarazione per confermare che l'intento è stato annullato.   
Tipo: oggetto [Statement](API_Statement.md)

 ** [sampleUtterances](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-sampleUtterances"></a>
Una serie di espressioni di esempio configurate per l'intento.   
Tipo: array di stringhe  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1500 articoli.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 200.

 ** [slots](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-slots"></a>
Una serie di tipi di slot che definisce le informazioni necessarie per soddisfare l'intento.  
Tipo: matrice di oggetti [Slot](API_Slot.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 100 elementi.

 ** [version](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-version"></a>
Il numero di versione assegnato alla nuova versione dell'intento.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `\$LATEST|[0-9]+` 

## Errori
<a name="API_CreateIntentVersion_Errors"></a>

 ** BadRequestException **   
La richiesta non è ben formulata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova.  
Codice di stato HTTP: 400

 ** ConflictException **   
 Si è verificato un conflitto nell'elaborazione della richiesta. Riprova la richiesta.   
Codice di stato HTTP: 409

 ** InternalFailureException **   
Si è verificato un errore interno di Amazon Lex. Riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
La richiesta ha superato il limite. Riprova la richiesta.  
Codice di stato HTTP: 429

 ** NotFoundException **   
La risorsa specificata nella richiesta non è stata trovata. Controlla la risorsa e riprova.  
Codice di stato HTTP: 404

 ** PreconditionFailedException **   
 Il checksum della risorsa che stai cercando di modificare non corrisponde al checksum della richiesta. Controlla il checksum della risorsa e riprova.  
Codice di stato HTTP: 412

## Vedi anche
<a name="API_CreateIntentVersion_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CreateIntentVersion)