GetBotVersions - Amazon Lex V1
Syntaxe de la demandeParamètres de demande URICorps de la requêteSyntaxe 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.

GetBotVersions

Permet d'obtenir des informations sur toutes les versions d'un bot.

L'GetBotVersionsopération renvoie un BotMetadata objet pour chaque version d'un bot. Par exemple, si un bot possède trois versions numérotées, l'GetBotVersionsopération renvoie quatre BotMetadata objets dans la réponse, un pour chaque version numérotée et un pour la $LATEST version.

L'GetBotVersionsopération renvoie toujours au moins une version, la $LATEST version.

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

Syntaxe de la demande

GET /bots/name/versions/?maxResults=maxResults&nextToken=nextToken HTTP/1.1

Paramètres de demande URI

La demande utilise les paramètres URI suivants.

maxResults

Le nombre maximum de versions de bot à renvoyer dans la réponse. La valeur par défaut est 10.

Plage valide : valeur minimum de 1. Valeur maximum de 50.

name

Nom du robot pour lequel les versions doivent être renvoyées.

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

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

Obligatoire : oui

nextToken

Un jeton de pagination pour récupérer la page suivante des versions du bot. Si la réponse à cet appel est tronquée, Amazon Lex renvoie un jeton de pagination dans la réponse. Pour récupérer la page de versions suivante, spécifiez le jeton de pagination dans la demande suivante.

Corps de la requête

La demande n’a pas de corps de requête.

Syntaxe de la réponse

HTTP/1.1 200
Content-type: application/json

{
   "bots": [ 
      { 
         "createdDate": number,
         "description": "string",
         "lastUpdatedDate": number,
         "name": "string",
         "status": "string",
         "version": "string"
      }
   ],
   "nextToken": "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.

bots

Un ensemble d'BotMetadataobjets, un pour chaque version numérotée du bot plus un pour la $LATEST version.

Type : tableau d’objets BotMetadata

nextToken

Un jeton de pagination pour récupérer la page suivante des versions du bot. Si la réponse à cet appel est tronquée, Amazon Lex renvoie un jeton de pagination dans la réponse. Pour récupérer la page de versions suivante, spécifiez le jeton de pagination dans la demande suivante.

Type : chaîne

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 :