PutBotAlias - Amazon Lex V1
Syntaxe de la demandeParamètres de demande URICorps de la demandeSyntaxe de la réponseEléments de réponseErreursconsultez aussi

Si vous utilisez Amazon Lex V2, consultez plutôt le guide Amazon Lex V2.

 

Si vous utilisez Amazon Lex V1, nous vous recommandons de mettre à niveau vos robots vers Amazon Lex V2. Nous n'ajoutons plus de nouvelles fonctionnalités à la V1 et recommandons vivement d'utiliser la V2 pour tous les nouveaux robots.

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

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.

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

Syntaxe de la demande

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

La demande utilise les paramètres URI suivants.

botName

Le nom du bot.

Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.

Modèle : ^([A-Za-z]_?)+$

Obligatoire : oui

name

Nom de l’alias. Le nom ne distingue pas les majuscules et minuscules.

Contraintes de longueur : longueur minimum de 1. Longueur maximum de 100.

Modèle : ^([A-Za-z]_?)+$

Obligatoire : oui

Corps de la demande

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

botVersion

La version du bot.

Type : chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.

Modèle : \$LATEST|[0-9]+

Obligatoire : oui

checksum

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

Paramètres des journaux de conversation pour l'alias.

Type : objet ConversationLogsRequest

Obligatoire : non

description

Description de l’alias.

Type : chaîne

Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.

Obligatoire : non

tags

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'PutBotAliasopé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

Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.

Obligatoire : non

Syntaxe de la réponse

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

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

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

Version du bot vers laquelle pointe l'alias.

Type : chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.

Modèle : \$LATEST|[0-9]+

checksum

Somme de contrôle pour la version actuelle de l'alias.

Type : chaîne

conversationLogs

Les paramètres qui déterminent la manière dont Amazon Lex utilise les journaux de conversation pour l'alias.

Type : objet ConversationLogsResponse

createdDate

Date à laquelle l'alias du bot a été créé.

Type : Timestamp

description

Description de l’alias.

Type : chaîne

Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.

lastUpdatedDate

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

Nom de l’alias.

Type : chaîne

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.

Modèle : ^([A-Za-z]_?)+$

tags

Liste des tags associés à un bot.

Type : tableau d’objets Tag

Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.

Erreurs

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

consultez aussi

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :