Aviso de fim do suporte: em 15 de setembro de 2025, o suporte para o Amazon Lex V1 AWS será interrompido. Após 15 de setembro de 2025, você não poderá mais acessar o console do Amazon Lex V1 nem os respectivos recursos. Se você estiver usando o Amazon Lex V2, consulte o [guia do Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html) em vez disso.
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Versionamento e aliases
O Amazon Lex oferece suporte a versões de publicação de bots, intenções e tipos de slot para que você possa controlar a implementação usada por seus aplicativos cliente. Uma *versão* é um snapshot numerado de seu trabalho que você pode publicar para uso em diferentes partes de seu fluxo de trabalho, como desenvolvimento, implementação beta e produção.
Os bots do Amazon Lex também oferecem suporte a aliases. Um *alias* é um ponteiro para uma versão específica de um bot. Com um alias, você pode atualizar com facilidade a versão que seus aplicativos cliente estão usando. Por exemplo, você pode apontar um alias para a versão 1 do seu bot. Quando tudo estiver pronto para atualizar o bot, você vai publicar a versão 2 e alterar o alias a fim de apontar para a nova versão. Como suas aplicações usam o alias ao invés de uma versão específica, todos os seus clientes obtêm a nova funcionalidade sem a necessidade de atualizações.
**Topics**
+ [Versionamento](#versioning-intro)
+ [Aliases](#aliases-intro)
## Versionamento
Quando você versiona um recurso do Amazon Lex, você cria um snapshot do recurso para que possa usar o recurso da forma como existia quando a versão foi criada. Após criar uma versão, ela permanecerá a mesma enquanto você continuar trabalhando no seu aplicativo.
### A versão \$1LATEST
Quando você cria um bot, intenção ou tipo de slot do Amazon Lex, há apenas uma versão, a versão `$LATEST`.
![\[The $LATEST version of a bot.\]](http://docs.aws.amazon.com/pt_br/lex/latest/dg/images/lex-only-bot.png)
`$LATEST` é a cópia de trabalho do seu recurso. Você pode atualizar apenas a versão `$LATEST`, e até você publicar sua primeira versão, `$LATEST` será a única versão do recurso.
Somente a versão `$LATEST` de um recurso pode usar a versão `$LATEST` do outro recurso. Por exemplo, a versão `$LATEST` de um bot pode usar a versão `$LATEST` de uma intenção, e a versão `$LATEST` de uma intenção pode usar a versão `$LATEST` de um tipo de slot.
A versão `$LATEST` do bot deve ser usada somente para testes manuais. O Amazon Lex limita o número de solicitações de runtime que você pode fazer para a versão `$LATEST` do bot.
### Publicação de uma versão de recurso do Amazon Lex
Quando você publica um recurso, o Amazon Lex faz uma cópia da versão `$LATEST` e salva como uma versão numerada. A versão publicada não pode ser alterada.
![\[Publishing a new version of the bot.\]](http://docs.aws.amazon.com/pt_br/lex/latest/dg/images/bot2.png)
Crie e publique as versões usando o console do Amazon Lex ou a operação [CreateBotVersion](API_CreateBotVersion.md). Para ver um exemplo, consulte [Exercício 3: publique uma versão e crie um alias](gettingstarted-ex3.md).
Quando você modifica a versão `$LATEST` de um recurso, pode publicar a nova versão para disponibilizar as alterações para os aplicativos de seus clientes. Toda vez que você publica uma versão, o Amazon Lex copia a versão `$LATEST` para criar a nova versão e incrementa 1 no número da versão. Os números de versão nunca são reutilizados. Por exemplo, se você remover a versão 10 numerada de um recurso e, em seguida, recriá-la, o próximo número de versão atribuído pelo Amazon Lex será a versão 11.
Para publicar um bot, você deve apontá-lo para uma versão numerada de qualquer intenção que ele use. Se você tentar publicar uma nova versão de um bot que usa a versão \$1LATEST versão de uma intenção, O Amazon Lex retorna uma exceção HTTP 400: solicitação inválida. Para publicar uma versão numerada da intenção, você deve apontar a intenção de uma versão numerada de qualquer tipo de slot que ele use. Caso contrário, você receberá uma exceção HTTP 400: solicitação inválida.
![\[Publishing a new version of $LATEST.\]](http://docs.aws.amazon.com/pt_br/lex/latest/dg/images/lex-publish-identical-bot.png)
**nota**
O Amazon Lex publica uma nova versão somente se a última versão publicada for diferente da versão `$LATEST`. Se você tentar publicar a versão `$LATEST` sem modificá-la, o Amazon Lex não criará nem publicará uma nova versão.
### Atualização de um recurso do Amazon Lex
Você pode atualizar apenas a versão `$LATEST` de um bot, uma intenção ou um tipo de slot do Amazon Lex. As versões publicadas não podem ser alteradas. Você pode publicar uma nova versão a qualquer momento após atualizar um recurso no console ou com as operações [CreateBotVersion](API_CreateBotVersion.md), [CreateIntentVersion](API_CreateIntentVersion.md) ou [CreateSlotTypeVersion](API_CreateSlotTypeVersion.md).
### Exclusão de um recurso ou uma versão do Amazon Lex.
O Amazon Lex oferece suporte à exclusão de um recurso ou versão usando o console ou uma das operações de API:
+ [DeleteBot](API_DeleteBot.md)
+ [DeleteBotVersion](API_DeleteBotVersion.md)
+ [DeleteBotAlias](API_DeleteBotAlias.md)
+ [DeleteBotChannelAssociation](API_DeleteBotChannelAssociation.md)
+ [DeleteIntent](API_DeleteIntent.md)
+ [DeleteIntentVersion](API_DeleteIntentVersion.md)
+ [DeleteSlotType](API_DeleteSlotType.md)
+ [DeleteSlotTypeVersion](API_DeleteSlotTypeVersion.md)
## Aliases
Um alias é um indicador para uma versão específica de um bot do Amazon Lex. Use um alias para permitir que os aplicativos de clientes usem uma versão específica do bot sem exigir que o aplicativo acompanhe qual é a versão.
O exemplo a seguir mostra duas versões de um bot do Amazon Lex, versão 1 e versão 2. Cada uma dessas versões de bot tem um alias associado, BETA e PROD, respectivamente. As aplicações dos clientes usam o alias PROD para acessar o bot.
![\[Point a client application to a version by using an alias.\]](http://docs.aws.amazon.com/pt_br/lex/latest/dg/images/lex-publish-alias-bot.png)
Ao criar uma segunda versão do bot, você pode atualizar o alias para apontar para a nova versão do bot usando o console ou a operação [PutBot](API_PutBot.md). Quando você altera o alias, todas as aplicações de seus clientes usam a nova versão. Se houver um problema com a nova versão, você poderá reverter para a versão anterior, simplesmente alterando o alias para apontar para essa versão.
![\[Updating an alias changes the version used by client applications.\]](http://docs.aws.amazon.com/pt_br/lex/latest/dg/images/lex-publish-alias-bot-v2.png)
**nota**
Embora você possa testar a versão `$LATEST` de um bot no console, recomendamos que, ao integrar um bot ao aplicativo do cliente, primeiro você publique uma versão e crie um alias que aponta para essa versão. Use o alias na aplicação de seus clientes pelos motivos explicados nesta seção. Quando você atualiza um alias, o Amazon Lex aguardará até que o tempo limite de sessão de todas as sessões atuais expire para começar a usar a nova versão. Para obter mais informações sobre tempo limite da sessão, consulte [Definição do tempo limite da sessão](context-mgmt-session-timeout.md)