

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: \_.:/=\+- 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