Versions et alias - Amazon Lex V1

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.

Versions et alias

Amazon Lex prend en charge la publication de versions de bots, d'intentions et de types d'emplacements afin que vous puissiez contrôler l'implémentation utilisée par vos applications clientes. Une version est un instantané numéroté de votre tâche que vous pouvez publier pour une utilisation dans différentes parties de votre flux de travail, par exemple, pour le développement, le déploiement bêta et la production.

Les robots Amazon Lex prennent également en charge les alias. Un alias est un pointeur vers une version spécifique d'un bot. Avec un alias, vous pouvez facilement mettre à jour la version que vos applications clientes utilisent. Par exemple, vous pouvez faire pointer un alias vers la version 1 de votre bot. Lorsque vous êtes prêt à mettre à jour le bot, vous publiez la version 2 et vous modifiez l'alias pour qu'il pointe vers la nouvelle version. Comme vos applications utilisent l'alias au lieu d'une version spécifique, tous vos clients obtiennent les nouvelles fonctionnalités sans avoir besoin d'être mis à jour.

Gestion des versions

Lorsque vous créez une version d'une ressource Amazon Lex, vous créez un instantané de la ressource afin de pouvoir utiliser la ressource telle qu'elle existait au moment de la création de la version. Une fois que vous créez une version, celle-ci il reste la même pendant que vous continuez à travailler sur votre application.

Version $LATEST

Lorsque vous créez un bot, une intention ou un type de slot Amazon Lex, il n'existe qu'une seule version, la $LATEST version.

The $LATEST version of a bot.

$LATEST est la copie de travail de votre ressource. Vous pouvez mettre à jour uniquement la version $LATEST et, tant que vous n'aurez pas publié votre première version, $LATEST est la seule version de la ressource que vous avez.

Seule la version $LATEST d'une ressource peut utiliser la version $LATEST d'une autre ressource. Par exemple, la version $LATEST d'un bot peut utiliser la version $LATEST d'une intention, et la version $LATEST d'une intention peut utiliser la version $LATEST d'un type d'option.

La $LATEST version de votre bot ne doit être utilisée que pour des tests manuels. Amazon Lex limite le nombre de demandes d'exécution que vous pouvez effectuer à la $LATEST version du bot.

Publication d'une version d'Amazon Lex Resource

Lorsque vous publiez une ressource, Amazon Lex en fait une copie et l'$LATESTenregistre sous forme de version numérotée. La version publiée ne peut pas être modifiée.

Publishing a new version of the bot.

Vous créez et publiez des versions à l'aide de la console Amazon Lex ou de l'CreateBotVersionopération. Pour obtenir un exemple, consultez Exercice 3 : Publication d'une version et création d'un alias.

Lorsque vous modifiez la version $LATEST d'une ressource, vous publiez la nouvelle version pour mettre les modifications à disposition des applications clientes. Chaque fois que vous publiez une version, Amazon Lex copie la $LATEST version pour créer la nouvelle version et augmente le numéro de version de 1. Les numéros de version ne sont jamais réutilisés. Par exemple, si vous supprimez une ressource numérotée version 10 puis que vous la recréez, le numéro de version suivant attribué par Amazon Lex est la version 11.

Avant de pouvoir publier un bot, vous devez renvoyer vers la version numérotée d'une intention qu'il utilise. Si vous essayez de publier une nouvelle version d'un bot qui utilise la version $LATEST d'une intention, Amazon Lex renvoie une exception de demande incorrecte HTTP 400. Avant de pouvoir publier une version numérotée de l'intention, vous devez renvoyer cette dernière vers la version numérotée d'un type d'option qu'elle utilise. Dans le cas contraire, vous obtiendrez une exception de demande incorrecte HTTP 400.

Publishing a new version of $LATEST.

Note

Amazon Lex publie une nouvelle version uniquement si la dernière version publiée est différente de la $LATEST version. Si vous essayez de publier la $LATEST version sans la modifier, Amazon Lex ne crée ni ne publie de nouvelle version.

Mettre à jour une ressource Amazon Lex

Vous ne pouvez mettre à jour que la $LATEST version d'un bot, d'une intention ou d'un type de slot Amazon Lex. Les versions publiées ne peuvent pas être modifiées. Vous pouvez publier une nouvelle version à tout moment après avoir mis à jour une ressource dans la console ou avec les opérations CreateBotVersion, CreateIntentVersion ou CreateSlotTypeVersion.

Supprimer une ressource ou une version d'Amazon Lex

Amazon Lex prend en charge la suppression d'une ressource ou d'une version à l'aide de la console ou de l'une des opérations de l'API :

Alias

Un alias est un pointeur vers une version spécifique d'un bot Amazon Lex. Utilisez un alias pour permettre aux applications clientes d'utiliser une version du bot sans que les applications aient besoin de savoir de quelle version spécifique il s'agit.

L'exemple suivant montre deux versions d'un bot Amazon Lex, la version 1 et la version 2. Chacune de ces versions de bot est associée à un alias, BETA et PROD, respectivement. Les applications clientes utilisent l'alias PROD pour accéder au bot.

Point a client application to a version by using an alias.

Lorsque vous créez une deuxième version du bot, vous pouvez mettre à jour l'alias pour qu'il renvoie vers cette nouvelle version à l'aide de la console ou de l'opération PutBot. Lorsque vous modifiez l'alias, toutes vos applications clientes utilisent la nouvelle version. S'il existe un problème lié à la nouvelle version, vous pouvez restaurer la version précédente en changeant simplement l'alias pour qu'il pointe vers cette version.

Updating an alias changes the version used by client applications.

Note

Même si vous pouvez tester la version $LATEST d'un bot dans la console, nous vous recommandons, lorsque vous intégrez un bot à une application cliente, de publier d'abord une version, puis de créer un alias qui renvoie vers cette version. Utilisez l'alias dans votre application cliente pour les raisons expliquées dans cette section. Lorsque vous mettez à jour un alias, Amazon Lex attend que le délai d'expiration de toutes les sessions en cours expire avant de commencer à utiliser la nouvelle version. Pour plus d'informations sur le délai d'expiration des sessions, consultez Définition du délai d'expiration d'une session.