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.

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

Crée une nouvelle version du bot en fonction de la `$LATEST` version. Si la `$LATEST` version de cette ressource n'a pas changé depuis que vous avez créé la dernière version, Amazon Lex ne crée pas de nouvelle version. Elle renvoie la dernière version créée.

**Note**  
Vous ne pouvez mettre à jour que la `$LATEST` version du bot. Vous ne pouvez pas mettre à jour les versions numérotées que vous créez avec cette `CreateBotVersion` opération.

 Lorsque vous créez la première version d'un bot, 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 nécessite une autorisation pour l’action `lex:CreateBotVersion`. 

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

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

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

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

La demande utilise les paramètres URI suivants.

 ** [name](#API_CreateBotVersion_RequestSyntax) **   <a name="lex-CreateBotVersion-request-uri-name"></a>
Nom du bot dont vous souhaitez créer une nouvelle version. Le nom est sensible à la casse.   
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

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

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

 ** [checksum](#API_CreateBotVersion_RequestSyntax) **   <a name="lex-CreateBotVersion-request-checksum"></a>
Identifie une révision spécifique de la `$LATEST` version du bot. Si vous spécifiez une somme de contrôle et que la `$LATEST` version du bot possède une somme de contrôle différente, une `PreconditionFailedException` exception est renvoyée et Amazon Lex 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_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"
}
```

## Eléments de réponse
<a name="API_CreateBotVersion_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.

 ** [abortStatement](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-abortStatement"></a>
Le message utilisé par Amazon Lex pour annuler une conversation. Pour de plus amples informations, veuillez consulter [PutBot](API_PutBot.md).  
Type : objet [Statement](API_Statement.md)

 ** [checksum](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-checksum"></a>
Somme de contrôle identifiant la version du bot qui a été créée.  
Type : Chaîne

 ** [childDirected](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-childDirected"></a>
Pour chaque bot Amazon Lex créé avec Amazon Lex Model Building Service, vous devez indiquer si votre utilisation d'Amazon Lex est liée à un site Web, à un programme ou à une autre application destiné ou ciblé, en tout ou en partie, aux enfants de moins de 13 ans et soumis à la loi COPPA (Children's Online Privacy Protection Act) en spécifiant `true` ou `false` dans le `childDirected` champ. `true`En spécifiant dans ce `childDirected` champ, vous confirmez que votre utilisation d'Amazon Lex **est** liée à un site Web, à un programme ou à une autre application destiné ou ciblé, en tout ou en partie, aux enfants de moins de 13 ans et soumis à la COPPA. `false`En spécifiant dans ce `childDirected` champ, vous confirmez que votre utilisation d'Amazon Lex **n'est pas** liée à un site Web, à un programme ou à une autre application destiné ou ciblé, en tout ou en partie, aux enfants de moins de 13 ans et soumis à la COPPA. Vous ne pouvez pas spécifier de valeur par défaut pour le `childDirected` champ qui ne reflète pas exactement si votre utilisation d'Amazon Lex est liée à un site Web, à un programme ou à une autre application destiné ou ciblé, en tout ou en partie, aux enfants de moins de 13 ans et soumis à la COPPA.  
Si votre utilisation d'Amazon Lex concerne un site Web, un programme ou une autre application destinés, en tout ou en partie, à des enfants de moins de 13 ans, vous devez obtenir le consentement parental vérifiable requis en vertu de la COPPA. Pour plus d'informations concernant l'utilisation d'Amazon Lex en relation avec des sites Web, des programmes ou d'autres applications destinés ou ciblés, en tout ou en partie, aux enfants de moins de 13 ans, consultez la [FAQ Amazon Lex.](https://aws.amazon.com/lex/faqs#data-security)   
Type : Boolean

 ** [clarificationPrompt](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-clarificationPrompt"></a>
Message utilisé par Amazon Lex lorsqu'il ne comprend pas la demande de l'utilisateur. Pour de plus amples informations, veuillez consulter [PutBot](API_PutBot.md).   
Type : objet [Prompt](API_Prompt.md)

 ** [createdDate](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-createdDate"></a>
Date à laquelle la version du bot a été créée.  
Type : Timestamp

 ** [description](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-description"></a>
Description du bot.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.

 ** [detectSentiment](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-detectSentiment"></a>
Indique si les énoncés saisis par l'utilisateur doivent être envoyés à Amazon Comprehend pour analyse des sentiments.  
Type : Boolean

 ** [enableModelImprovements](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-enableModelImprovements"></a>
Indique si le bot utilise des améliorations de précision. `true`indique que le bot utilise les améliorations, sinon,`false`.  
Type : Boolean

 ** [failureReason](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-failureReason"></a>
Dans `status` l'affirmative`FAILED`, Amazon Lex fournit la raison pour laquelle il n'a pas réussi à créer le bot.  
Type : Chaîne

 ** [idleSessionTTLInSeconds](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-idleSessionTTLInSeconds"></a>
Durée maximale en secondes pendant laquelle Amazon Lex conserve les données collectées au cours d'une conversation. Pour de plus amples informations, veuillez consulter [PutBot](API_PutBot.md).  
Type : Integer  
Plage valide : Valeur minimum de 60. Valeur maximum de 86 400.

 ** [intents](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-intents"></a>
Tableau d’objets `Intent`. Pour de plus amples informations, veuillez consulter [PutBot](API_PutBot.md).  
Type : tableau d’objets [Intent](API_Intent.md)

 ** [lastUpdatedDate](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-lastUpdatedDate"></a>
Date à laquelle la `$LATEST` version de ce bot a été mise à jour.   
Type : Timestamp

 ** [locale](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-locale"></a>
 Spécifie les paramètres régionaux cibles pour le bot.   
Type : Chaîne  
Valeurs valides : `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>
Le nom du bot.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [status](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-status"></a>
 Lorsque vous envoyez une demande de création ou de mise à jour d'un bot, Amazon Lex définit l'élément de `status` réponse sur`BUILDING`. Une fois qu'Amazon Lex a créé le bot, celui-ci `status` passe à`READY`. Si Amazon Lex ne parvient pas à créer le bot, il est `status` configuré sur`FAILED`. Amazon Lex renvoie la raison de l'échec dans l'élément de `failureReason` réponse.   
Type : Chaîne  
Valeurs valides : `BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT` 

 ** [version](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-version"></a>
La version du bot.   
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `\$LATEST|[0-9]+` 

 ** [voiceId](#API_CreateBotVersion_ResponseSyntax) **   <a name="lex-CreateBotVersion-response-voiceId"></a>
L'identifiant vocal Amazon Polly utilisé par Amazon Lex pour les interactions vocales avec l'utilisateur.  
Type : Chaîne

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