Avis de fin de support : le 15 septembre 2025, le support pour Amazon Lex V1 AWS sera interrompu. Après le 15 septembre 2025, vous ne pourrez plus accéder à la console Amazon Lex V1 ni aux ressources Amazon Lex V1. Si vous utilisez Amazon Lex V2, consultez plutôt le [guide Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html). 

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Crée une nouvelle version d'une intention en fonction de la `$LATEST` version de l'intention. Si la `$LATEST` version de cette intention n'a pas changé depuis votre dernière mise à jour, Amazon Lex ne crée pas de nouvelle version. Elle renvoie la dernière version que vous avez créée.

**Note**  
Vous ne pouvez mettre à jour que la `$LATEST` version de l'intention. Vous ne pouvez pas mettre à jour les versions numérotées que vous créez avec cette `CreateIntentVersion` opération.

 Lorsque vous créez une version d'une intention, Amazon Lex définit la version sur 1. Les versions suivantes sont incrémentées de 1. Pour de plus amples informations, veuillez consulter [Gestion des versions](versioning-aliases.md#versioning-intro). 

Cette opération exige des autorisations pour exécuter l'action `lex:CreateIntentVersion`. 

## Syntaxe de la demande
<a name="API_CreateIntentVersion_RequestSyntax"></a>

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

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

## Paramètres de demande URI
<a name="API_CreateIntentVersion_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [name](#API_CreateIntentVersion_RequestSyntax) **   <a name="lex-CreateIntentVersion-request-uri-name"></a>
Nom de l'intention dont vous souhaitez créer une nouvelle version. Le nom est sensible à la casse.   
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

## Corps de la demande
<a name="API_CreateIntentVersion_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [checksum](#API_CreateIntentVersion_RequestSyntax) **   <a name="lex-CreateIntentVersion-request-checksum"></a>
Somme de contrôle de la `$LATEST` version de l'intention qui doit être utilisée pour créer la nouvelle version. Si vous spécifiez une somme de contrôle et que la `$LATEST` version de l'intention possède une somme de contrôle différente, Amazon Lex renvoie une `PreconditionFailedException` exception et ne publie pas de nouvelle version. Si vous ne spécifiez pas de somme de contrôle, Amazon Lex publie la `$LATEST` version.  
Type : chaîne  
Obligatoire : non

## Syntaxe de la réponse
<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"
}
```

## Eléments de réponse
<a name="API_CreateIntentVersion_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 201.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [checksum](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-checksum"></a>
Somme de contrôle de la version intentionnelle créée.  
Type : Chaîne

 ** [conclusionStatement](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-conclusionStatement"></a>
Une fois que la fonction Lambda spécifiée dans le `fulfillmentActivity` champ répond à l'intention, Amazon Lex transmet cette déclaration à l'utilisateur.   
Type : objet [Statement](API_Statement.md)

 ** [confirmationPrompt](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-confirmationPrompt"></a>
Si elle est définie, l'invite qu'Amazon Lex utilise pour confirmer l'intention de l'utilisateur avant de la concrétiser.   
Type : objet [Prompt](API_Prompt.md)

 ** [createdDate](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-createdDate"></a>
Date à laquelle l'intention a été créée.  
Type : Timestamp

 ** [description](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-description"></a>
Une description de l'intention.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.

 ** [dialogCodeHook](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-dialogCodeHook"></a>
Si elle est définie, Amazon Lex invoque cette fonction Lambda pour chaque entrée utilisateur.  
Type : objet [CodeHook](API_CodeHook.md)

 ** [followUpPrompt](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-followUpPrompt"></a>
Si elle est définie, Amazon Lex utilise cette invite pour solliciter une activité supplémentaire des utilisateurs une fois que l'intention a été remplie.   
Type : objet [FollowUpPrompt](API_FollowUpPrompt.md)

 ** [fulfillmentActivity](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-fulfillmentActivity"></a>
 Décrit comment l'intention est atteinte.   
Type : objet [FulfillmentActivity](API_FulfillmentActivity.md)

 ** [inputContexts](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-inputContexts"></a>
Tableau d'`InputContext`objets répertoriant les contextes qui doivent être actifs pour qu'Amazon Lex puisse choisir l'intention d'une conversation avec l'utilisateur.  
Type : tableau d’objets [InputContext](API_InputContext.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 5 éléments.

 ** [kendraConfiguration](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-kendraConfiguration"></a>
Informations de configuration, le cas échéant, pour connecter un index Amazon Kendra à l'`AMAZON.KendraSearchIntent`intention.  
Type : objet [KendraConfiguration](API_KendraConfiguration.md)

 ** [lastUpdatedDate](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-lastUpdatedDate"></a>
Date à laquelle l'intention a été mise à jour.   
Type : Timestamp

 ** [name](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-name"></a>
Nom de l'intention.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [outputContexts](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-outputContexts"></a>
Tableau d'`OutputContext`objets répertoriant les contextes que l'intention active lorsque l'intention est atteinte.  
Type : tableau d’objets [OutputContext](API_OutputContext.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 éléments.

 ** [parentIntentSignature](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-parentIntentSignature"></a>
Identifiant unique pour une intention intégrée.  
Type : Chaîne

 ** [rejectionStatement](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-rejectionStatement"></a>
Si l'utilisateur répond « non » à la question définie dans`confirmationPrompt`, Amazon Lex répond par cette déclaration pour reconnaître que l'intention a été annulée.   
Type : objet [Statement](API_Statement.md)

 ** [sampleUtterances](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-sampleUtterances"></a>
Un ensemble d'exemples d'énoncés configurés en fonction de l'intention.   
Type : tableau de chaînes  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 1500 articles.  
Contraintes de longueur : longueur minimale de 1. Longueur maximum de 200.

 ** [slots](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-slots"></a>
Un ensemble de types d'emplacements qui définit les informations requises pour atteindre l'objectif.  
Type : tableau d’objets [Slot](API_Slot.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 100 éléments.

 ** [version](#API_CreateIntentVersion_ResponseSyntax) **   <a name="lex-CreateIntentVersion-response-version"></a>
Le numéro de version attribué à la nouvelle version de l'intention.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `\$LATEST|[0-9]+` 

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

 ** BadRequestException **   
La demande n'est pas bien formulée. Par exemple, une valeur n'est pas valide ou un champ obligatoire est manquant. Vérifiez les valeurs des champs, puis réessayez.  
Code d’état HTTP : 400

 ** ConflictException **   
 Un conflit s'est produit lors du traitement de la demande. Réessayez votre demande.   
Code d’état HTTP : 409

 ** InternalFailureException **   
Une erreur interne Amazon Lex s'est produite. Réessayez votre demande.  
Code d’état HTTP : 500

 ** LimitExceededException **   
La demande a dépassé une limite. Réessayez votre demande.  
Code d’état HTTP : 429

 ** NotFoundException **   
La ressource spécifiée dans la demande est introuvable. Vérifiez la ressource et réessayez.  
Code d’état HTTP :404

 ** PreconditionFailedException **   
 La somme de contrôle de la ressource que vous essayez de modifier ne correspond pas à la somme de contrôle de la demande. Vérifiez le checksum de la ressource et réessayez.  
Code d’état HTTP : 412

## Voir aussi
<a name="API_CreateIntentVersion_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/CreateIntentVersion) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/CreateIntentVersion)