Control de versiones y alias - Amazon Lex V1

Si utiliza Amazon Lex V2, consulte la guía de Amazon Lex V2.

 

Si utiliza Amazon Lex V1, le recomendamos que actualice los bots a Amazon Lex V2. Hemos dejado de agregar nuevas características a V1, por lo que recomendamos encarecidamente utilizar V2 para todos los nuevos bots.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Control de versiones y alias

Amazon Lex admite la publicación de versiones de bots, intenciones y tipos de ranura para que pueda determinar la implementación que usan las aplicaciones cliente. Una versión es una instantánea numerada de su trabajo que puede publicar para su uso en diferentes partes del flujo de trabajo, como, por ejemplo, el desarrollo, la implementación beta y la producción.

Los bots de Amazon Lex también admiten alias. Un alias es un puntero hacia una versión específica de un bot. Con un alias, puede actualizar fácilmente la versión que usan las aplicaciones cliente. Por ejemplo, puede apuntar un alias hacia la versión 1 de su bot. Cuando esté listo para actualizar el bot, puede publicar la versión 2 y cambiar el alias para que apunte a la nueva versión. Dado que sus aplicaciones utilizan el alias en lugar de una versión específica, todos los clientes obtienen las nuevas funcionalidades sin necesidad de actualizarse.

Control de versiones

Cuando define una versión de un recurso de Amazon Lex, crea una instantánea del recurso para utilizarlo tal y como estaba en el momento de crear la versión. Después de crear una versión, esta no cambiará mientras continúa trabajando en su aplicación.

La versión $LATEST

Al crear un bot, una intención o un tipo de ranura de Amazon Lex, solo hay una versión: $LATEST.

The $LATEST version of a bot.

$LATEST es la copia de trabajo de su recurso. Solo puede actualizar la versión $LATEST y, hasta que publique la primera versión, $LATEST es la única versión del recurso con la que cuenta.

La versión $LATEST de un recurso es la única que puede utilizar la versión $LATEST de otro recurso. Por ejemplo, la versión $LATEST de un bot puede utilizar la versión $LATEST de una intención y la versión $LATEST de una intención puede utilizar la versión $LATEST de un tipo de slot.

La versión $LATEST del bot solo debería utilizarse para llevar a cabo pruebas manuales. Amazon Lex limita el número de solicitudes en tiempo de ejecución que puede realizar a la versión $LATEST del bot.

Publicación de una versión de un recurso de Amazon Lex

Al publicar un recurso, Amazon Lex realiza una copia de la versión $LATEST y la guarda como versión numerada. La versión publicada no se puede cambiar.

Publishing a new version of the bot.

Puede crear y publicar versiones con la consola de Amazon Lex o la operación CreateBotVersion. Para ver un ejemplo, consulte Ejercicio 3: publicación de una versión y creación de un alias.

Si modifica la versión $LATEST de un recurso, puede publicar la nueva versión para que los cambios estén disponibles para sus aplicaciones cliente. Cada vez que publique una versión, Amazon Lex copiará la versión $LATEST para crear la nueva e incrementará el número de versión en 1. Los números de versión nunca se reutilizan. Por ejemplo, si suprime la versión numerada del recurso 10 y, a continuación, la vuelve a crear, el siguiente número de versión que asigne Amazon Lex será el 11.

Antes de publicar un bot, debe hacer que apunte a una versión numerada de cualquier intención que utilice. Si intenta publicar una nueva versión de un bot que utiliza la versión $LATEST de una intención, Amazon Lex devuelve la excepción HTTP 400 Bad Request. Antes de publicar una versión numerada de la intención, debe hacer que esta apunte a una versión numerada de cualquier tipo de slot que utilice. De lo contrario, obtendrá una excepción HTTP 400 Bad Request.

Publishing a new version of $LATEST.

nota

Amazon Lex publica una nueva versión solo si la última versión publicada es diferente de la versión $LATEST. Si intenta publicar la versión $LATEST sin modificarla, Amazon Lex no creará ni publicará una nueva versión.

Actualización de un recurso de Amazon Lex

Solo puede actualizar la versión $LATEST de un bot, intención o tipo de slot de Amazon Lex. Las versiones publicadas no se pueden cambiar. Puede publicar una nueva versión en cualquier momento después de actualizar un recurso en la consola o con las operaciones CreateBotVersion, CreateIntentVersion o CreateSlotTypeVersion.

Eliminación de un recurso o versión de Amazon Lex

Amazon Lex permite eliminar un recurso o versión mediante la consola o una de las operaciones de la API:

Alias

Un alias es un puntero a una versión específica de un bot de Amazon Lex. Utilice un alias para permitir que las aplicaciones cliente utilicen una versión específica del bot sin necesidad de que la aplicación realice un seguimiento de la versión de que se trata.

En el siguiente ejemplo se muestran dos versiones de un bot de Amazon Lex, la versión 1 y la versión 2. Cada una de estas versiones de bot tiene un alias asociado, BETA y PROD, respectivamente. Las aplicaciones cliente usan el alias PROD para acceder al bot.

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

Al crear una segunda versión del bot, puede actualizar el alias para que apunte a la nueva versión del bot utilizando la consola o la operación PutBot. Al cambiar el alias, todas sus aplicaciones cliente utilizan la nueva versión. Si hay un problema con la nueva versión, puede volver a la versión anterior simplemente haciendo que el alias apunte hacia dicha versión.

Updating an alias changes the version used by client applications.

nota

Aunque puede probar la versión $LATEST de un bot en la consola, le recomendamos que, al integrar un bot con la aplicación cliente, primero publique una versión y cree un alias que apunte a dicha versión. Utilice el alias de la aplicación cliente por las razones explicadas en esta sección. Al actualizar un alias, Amazon Lex esperará a que transcurra el tiempo de espera en todas las sesiones actuales antes de comenzar a utilizar la nueva versión. Para obtener más información acerca del tiempo de espera de la sesión, consulte Definición del tiempo de espera de la sesión.