

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á.

# Recursos de marcação no Lex V2
<a name="tagging"></a>

Para ajudá-lo a gerenciar os bots e aliases de bot do Amazon Lex V2 é possível atribuir metadados a cada recurso como *tags*. Uma tag é um rótulo atribuído a um recurso da AWS. Cada tag consiste em uma chave e um valor. 

As tags permitem categorizar seus recursos da AWS de diferentes formas, por exemplo, por finalidade, proprietário ou aplicativo. As tags ajudam a:
+ Identifique e organize seus recursos da AWS. Muitos recursos da AWS oferecem suporte à marcação, então você pode atribuir a mesma tag a recursos em serviços diferentes para indicar que os recursos são os mesmos. Por exemplo, é possível marcar um bot e as funções do Lambda que ele usa com a mesma tag.
+ Alocar custos. Você ativa as tags no Gerenciamento de Faturamento e Custos da AWS painel. A AWS usa as tags para categorizar seus custos e fornecer um relatório mensal de alocação de custos mensais a você. Para o Amazon Lex V2, é possível alocar custos para cada alias usando tags específicas para o alias. Para obter mais informações, consulte [Usar etiquetas de alocação de custos](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) no *Guia do Usuário do Gerenciamento de Faturamento e Custos da AWS*.
+ Controle o acesso aos recursos da . Você pode usar tags com o Amazon Lex V2 para criar políticas para controlar o acesso aos recursos do Amazon Lex V2. Essas políticas podem ser anexadas a um usuário ou perfil do IAM para permitir o controle de acesso baseado em tags.

Você pode trabalhar com tags usando o AWS Management ConsoleAWS Command Line Interface, o ou a API Amazon Lex V2.

## Marcação de recursos com o console ou a API
<a name="tagging-resources"></a>

Se estiver usando o console do Amazon Lex V2, é possível marcar recursos ao criá-los ou adicionar as tags mais tarde. Também é possível usar o console para atualizar ou remover tags existentes.

Se você estiver usando a AWS CLI ou a API Amazon Lex V2, você usa as seguintes operações para gerenciar tags para seu recurso:
+ [CreateBot](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateBot.html) e [CreateBotAlias](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateBotAlias.html): aplicar as tags ao criar um bot ou alias de bot.
+ [ListTagsForResource](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListTagsForResource.html): visualizar as tags associadas a um recurso.
+ [TagResource](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_TagResource.html): adicionar e modificar tags em um recurso existente.
+ [UntagResource](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UntagResource.html): remover as tags de um recurso.

Os seguintes recursos do Amazon Lex V2 são compatíveis com a marcação:
+ Bots: use um nome do recurso da Amazon (ARN) como o seguinte:
  + `arn:aws:lex:${Region}:${account}:bot/${bot-id}`
+ Aliases de bot: use um ARN como o seguinte:
  + `arn:aws:lex:${Region}:${account}:bot-alias/${bot-id}/${bot-alias-id}`

Os valores `bot-id` e `bot-alias-id` são strings alfanuméricas em maiúsculas de 10 caracteres.

## Restrições de tags ao usar o Lex V2
<a name="tagging-restrictions"></a>

As restrições básicas a seguir se aplicam às tags nos recursos do Amazon Lex V2:
+ Número máximo de chaves: 50 usando o console, 200 usando a API
+ Tamanho máximo da chave: 128 caracteres
+ Tamanho máximo do valor: 256 caracteres
+ Caracteres válidos de chave e valor: a-z, A-Z, 0-9, espaço e os seguintes caracteres: \$1.:/=\$1- e @
+ As chaves e os valores diferenciam letras maiúsculas de minúsculas
+ Não use `aws:` como prefixo para chaves, ele é reservado para uso da AWS

# Marcar recursos (console)
<a name="tags-console"></a>

É possível usar o console para gerenciar tags em um bot ou alias de bot. É possível adicionar tags ao criar um recurso ou adicionar, modificar ou remover tags de recursos existentes.

**Como adicionar uma tag ao criar um bot**

1. Faça login no AWS Management Console e abra o console do Amazon Lex em [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).

1. Escolha **Criar bot**.

1. Na seção **Configurações avançadas** de **Definir configurações do bot**, escolha **Adicionar nova tag**. Você pode adicionar tags ao bot e ao alias do `TestBotAlias`.

1. Selecione **Próximo** para continuar a criação do seu bot.

**Como adicionar uma tag ao criar um alias de bot**

1. Faça login no AWS Management Console e abra o console do Amazon Lex em [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).

1. Escolha o bot ao qual você deseja adicionar o alias de bot.

1. No menu esquerdo, escolha **Aliases** e depois **Criar alias**.

1. Em **Informações gerais**, escolha **Adicionar nova tag** em **Tags.**

1. Escolha **Criar**.

**Como adicionar, remover ou modificar uma tag em um bot existente**

1. Faça login no AWS Management Console e abra o console do Amazon Lex em [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).

1. Escolha o bot que você deseja modificar.

1. No menu esquerdo, escolha **Configurações** e, em seguida, **Editar**.

1. Em **Tags**, faça suas alterações.

1. Escolha **Salvar** para salvar suas alterações no bot.

**Para adicionar, remover ou modificar uma tag em um alias existente**

1. Faça login no AWS Management Console e abra o console do Amazon Lex em [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).

1. Escolha o bot que você deseja modificar.

1. No menu à esquerda, escolha **Aliases** e, na lista de aliases, escolha o alias a ser modificado.

1. Em **Detalhes do alias**, em **Tags**, escolha **Modificar tags**.

1. Em **Gerenciar tags**, faça suas alterações.

1. Escolha **Salvar** para salvar as alterações no alias.