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.

# PutBotAlias
<a name="API_PutBotAlias"></a>

Crée un alias pour la version spécifiée du bot ou remplace un alias pour le bot spécifié. Pour modifier la version du bot vers laquelle pointe l'alias, remplacez l'alias. Pour en savoir plus sur les alias, consultez la section [Versions et alias](versioning-aliases.md).

Cette opération exige des autorisations pour l’action `lex:PutBotAlias`. 

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

```
PUT /bots/botName/aliases/name HTTP/1.1
Content-type: application/json

{
   "botVersion": "string",
   "checksum": "string",
   "conversationLogs": { 
      "iamRoleArn": "string",
      "logSettings": [ 
         { 
            "destination": "string",
            "kmsKeyArn": "string",
            "logType": "string",
            "resourceArn": "string"
         }
      ]
   },
   "description": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}
```

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

La demande utilise les paramètres URI suivants.

 ** [botName](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-uri-botName"></a>
Le nom du bot.  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$`   
Obligatoire : oui

 ** [name](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-uri-name"></a>
Nom de l’alias. Le nom *ne distingue pas les majuscules* et minuscules.  
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_PutBotAlias_RequestBody"></a>

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

 ** [botVersion](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-botVersion"></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]+`   
Obligatoire : oui

 ** [checksum](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-checksum"></a>
Identifie une révision spécifique de la `$LATEST` version.  
Lorsque vous créez un nouvel alias de bot, laissez le `checksum` champ vide. Si vous spécifiez une somme de contrôle, vous obtenez une `BadRequestException` exception.  
Lorsque vous souhaitez mettre à jour l'alias d'un bot, définissez le `checksum` champ sur la somme de contrôle de la dernière révision de la `$LATEST` version. Si vous ne spécifiez pas le ` checksum` champ, ou si la somme de contrôle ne correspond pas à la `$LATEST` version, vous obtenez une `PreconditionFailedException` exception.  
Type : chaîne  
Obligatoire : non

 ** [conversationLogs](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-conversationLogs"></a>
Paramètres des journaux de conversation pour l'alias.  
Type : objet [ConversationLogsRequest](API_ConversationLogsRequest.md)  
Obligatoire : non

 ** [description](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-description"></a>
Description de l’alias.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.  
Obligatoire : non

 ** [tags](#API_PutBotAlias_RequestSyntax) **   <a name="lex-PutBotAlias-request-tags"></a>
Liste des balises à ajouter à l'alias du bot. Vous ne pouvez ajouter des balises que lorsque vous créez un alias. Vous ne pouvez pas utiliser l'`PutBotAlias`opération pour mettre à jour les balises d'un alias de bot. Pour mettre à jour les balises, utilisez l'opération `TagResource`.  
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_PutBotAlias_ResponseSyntax"></a>

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

{
   "botName": "string",
   "botVersion": "string",
   "checksum": "string",
   "conversationLogs": { 
      "iamRoleArn": "string",
      "logSettings": [ 
         { 
            "destination": "string",
            "kmsKeyArn": "string",
            "logType": "string",
            "resourceArn": "string",
            "resourcePrefix": "string"
         }
      ]
   },
   "createdDate": number,
   "description": "string",
   "lastUpdatedDate": number,
   "name": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}
```

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

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

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

 ** [botName](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-botName"></a>
Nom du robot sur lequel l'alias pointe.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.  
Modèle : `^([A-Za-z]_?)+$` 

 ** [botVersion](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-botVersion"></a>
Version du bot vers laquelle pointe l'alias.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.  
Modèle : `\$LATEST|[0-9]+` 

 ** [checksum](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-checksum"></a>
Somme de contrôle pour la version actuelle de l'alias.  
Type : Chaîne

 ** [conversationLogs](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-conversationLogs"></a>
Les paramètres qui déterminent la manière dont Amazon Lex utilise les journaux de conversation pour l'alias.  
Type : objet [ConversationLogsResponse](API_ConversationLogsResponse.md)

 ** [createdDate](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-createdDate"></a>
Date à laquelle l'alias du bot a été créé.  
Type : Timestamp

 ** [description](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-description"></a>
Description de l’alias.  
Type : chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.

 ** [lastUpdatedDate](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-lastUpdatedDate"></a>
Date à laquelle l'alias du bot a été mis à jour. Lorsque vous créez une ressource, la date de création et la date de dernière mise à jour sont identiques.  
Type : Timestamp

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

 ** [tags](#API_PutBotAlias_ResponseSyntax) **   <a name="lex-PutBotAlias-response-tags"></a>
Liste des tags associés à un bot.  
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.

## Erreurs
<a name="API_PutBotAlias_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

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