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.
GetBotAlias
Renvoie des informations sur un alias de bot Amazon Lex. Pour en savoir plus sur les alias, consultez la section Versions et alias.
Cette opération exige des autorisations pour l'action lex:GetBotAlias
.
Syntaxe de la demande
GET /bots/botName
/aliases/name
HTTP/1.1
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
-
Le nom de l'alias du bot. Le nom est sensible à la casse.
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 100.
Modèle :
^([A-Za-z]_?)+$
Obligatoire : oui
Corps de la demande
La demande n’a pas de corps de requête.
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"
}
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 de l'alias du bot.
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 du bot.
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
-
Le nom de l'alias du bot.
Type : chaîne
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.
Modèle :
^([A-Za-z]_?)+$
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
- 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
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 :