# Marcando seus Recursos AWS WA Tool
Para ajudar no gerenciamento de recursos do AWS WA Tool, você pode atribuir seus próprios metadados a cada recurso em forma de *tags*. Este tópico descreve as tags e como criá-las.
**Topics**
+ [Conceitos Básicos de Tags](#tag-basics)
+ [Marcando seus Recursos](#tag-resources)
+ [Restrições de tag](#tag-restrictions)
+ [Trabalhando com tags usando o console](#tag-resources-console)
+ [Trabalhar com tags usando a API](#tag-resources-api-sdk)
## Conceitos Básicos de Tags
Uma tag um rótulo atribuído a um recurso da AWS. Cada tag consiste em uma *chave* e um *valor* opcional, ambos definidos por você.
As tags permitem categorizar seus recursos da AWS por finalidade, proprietário ou ambiente, por exemplo. Caso possua muitos recursos do mesmo tipo, você pode identificar rapidamente um recurso específico com base nas tags atribuídas a ele. Por exemplo, é possível definir um conjunto de tags para seus serviços do AWS WA Tool para ajudá-lo a rastrear o proprietário e nível da pilha de cada serviço. Recomendamos planejar um conjunto consistente de chaves de tags para cada tipo de recurso.
Tags não são automaticamente atribuídas aos recursos. Após adicionar uma tag, você pode editar as chaves e os valores das tags ou removê-las de um recurso a qualquer momento. Caso exclua um recurso, todas as respectivas tags também serão excluídas.
As tags não têm significado semântico atrelado ao AWS WA Tool e são interpretadas estritamente como string de caracteres. É possível definir o valor de uma tag em uma string vazia, mas não configurar o valor de um tag como nula. Caso adicione uma tag com a mesma chave de outra existente no recurso, o novo valor substituirá o antigo.
Você pode trabalhar com tags usando o Console de gerenciamento da AWS, o AWS CLI e a API do AWS WA Tool.
Se estiver usando o AWS Identity and Access Management (IAM), você poderá controlar quais usuários da sua Conta da AWS têm permissão para criar, editar ou excluir tags.
## Marcando seus Recursos
Você pode marcar recursos do AWS WA Tool novos ou existentes.
Se estiver usando o console do AWS WA Tool, você poderá aplicar tags a novos recursos quando eles forem criados ou a recursos existentes a qualquer momento. Para workloads existentes, você pode aplicar tags na guia **Propriedades**. Para lentes personalizadas, perfis e modelos de avaliação existentes, você pode aplicar tags na guia **Visão geral**.
Caso esteja usando a API do AWS WA Tool, o AWS CLI ou SDK da AWS, é possível aplicar tags a novos recursos por meio do parâmetro de `tags` na ação API relevante ou, para recursos existentes, da ação API `TagResource`. Para mais informações, consulte [TagResource](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_TagResource.html).
Algumas ações de criação de recursos permitem especificar tags para um recurso quando o mesmo for criado. Caso as tags não possam ser aplicadas durante a criação dos recursos, haverá falha no processo de criação de recursos. Isso garante que recursos que você pretenda marcar na criação sejam criados com as tags especificadas ou não. Caso marque recursos no momento da criação, não precisará executar scripts de marcação personalizados após a criação do recurso.
A tabela a seguir descreve os recursos AWS WA Tool que podem ser marcados com tags e aqueles que podem ser marcados na criação.
**Suporte à marcação para recursos AWS WA Tool**
| Recurso | Compatível com tags | Compatível com a propagação de tags | Compatível com o uso de tags na criação (API do AWS WA Tool, AWS CLI e SDK da AWS) |
| --- | --- | --- | --- |
| Workloads do AWS WA Tool | Sim | Não | Sim |
| Lentes personalizadas do AWS WA Tool | Sim | Não | Sim |
| Perfis do AWS WA Tool | Sim | Não | Sim |
| Modelos de avaliação do AWS WA Tool | Sim | Não | Sim |
## Restrições de tag
As restrições básicas a seguir se aplicam a tags:
+ Número máximo de tags por recurso:- 50
+ Em todos os recursos, cada chave de tag deve ser exclusiva e possuir apenas um valor.
+ Comprimento máximo da chave:- 128 caracteres Unicode em UTF-8
+ Comprimento máximo do valor:- 256 caracteres Unicode em UTF-8
+ Caso seu esquema de marcação seja usado em vários serviços e recursos da AWS, lembre-se de que outros serviços podem possuir restrições em caracteres permitidos. Em geral, caracteres permitidos incluem letras, números, espaços representáveis em UTF-8 e os caracteres \+ - = . \_ : / @.
+ Chaves e valores de tags diferenciam maiúsculas de minúsculas.
+ Não use `aws:`, `AWS:` ou qualquer combinação de letras maiúsculas e minúsculas como um prefixo para chaves ou valores, uma vez que as mesmas são reservadas para uso pela AWS. Você não pode editar nem excluir chaves ou valores de tags com esse prefixo. Tags com esse prefixo não contam em limites de tags por recurso.
## Trabalhando com tags usando o console
Usando o console do AWS WA Tool, você pode gerenciar as tags associadas a recursos novos ou existentes.
### Adicionar tags a um recurso individual na criação
Você pode adicionar tags aos recursos do AWS WA Tool ao criá-los.
### Adicionando e excluindo tags em um recurso individual
O AWS WA Tool permite adicionar ou excluir tags associadas aos seus recursos diretamente da guia **Propriedades** para uma workload e da guia **Visão geral** para lentes personalizadas, perfis e modelos de avaliação.
**Para adicionar ou excluir uma tag em uma workload**
1. Faça login no Console de gerenciamento da AWS e abra o console do AWS Well-Architected Tool em [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/).
1. Na barra de navegação, selecione a região a ser usada.
1. No painel de navegação, selecione **Workloads**.
1. Selecione a workload a ser modificada e escolha **Propriedades**.
1. Na seção **Tags**, escolha **Gerenciar tags**.
1. Adicione ou exclua as tags conforme necessário.
+ Para adicionar uma tag, escolha **Adicionar nova tag** e preencha os campos **Chave** e **Valor**.
+ Para excluir uma tag, escolha **Remove** (Remover).
1. Repita esse processo para cada tag que você deseja adicionar, modificar ou excluir. Escolha **Salvar** para salvar as alterações.
**Para adicionar ou excluir uma tag em uma lente personalizada**
1. Faça login no Console de gerenciamento da AWS e abra o console do AWS Well-Architected Tool em [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/).
1. Na barra de navegação, selecione a região a ser usada.
1. No painel de navegação, escolha **Lentes personalizadas**.
1. Selecione o nome da lente personalizada a ser modificada.
1. Na seção **Tags** da guia **Visão geral**, escolha **Gerenciar tags**.
1. Adicione ou exclua as tags conforme necessário.
+ Para adicionar uma tag, escolha **Adicionar nova tag** e preencha os campos **Chave** e **Valor**.
+ Para excluir uma tag, escolha **Remove** (Remover).
1. Repita esse processo para cada tag que você deseja adicionar, modificar ou excluir. Escolha **Salvar** para salvar as alterações.
**Para adicionar ou excluir uma tag em um perfil**
1. Faça login no Console de gerenciamento da AWS e abra o console do AWS Well-Architected Tool em [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/).
1. Na barra de navegação, selecione a região a ser usada.
1. No painel de navegação, escolha **Perfis**.
1. Selecione o nome do perfil a ser modificado.
1. Na seção **Tags** da guia **Visão geral**, escolha **Gerenciar tags**.
1. Adicione ou exclua as tags conforme necessário.
+ Para adicionar uma tag, escolha **Adicionar nova tag** e preencha os campos **Chave** e **Valor**.
+ Para excluir uma tag, escolha **Remove** (Remover).
1. Repita esse processo para cada tag que você deseja adicionar, modificar ou excluir. Escolha **Salvar** para salvar as alterações.
**Para adicionar ou excluir uma tag em um modelo de avaliação**
1. Faça login no Console de gerenciamento da AWS e abra o console do AWS Well-Architected Tool em [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/).
1. Na barra de navegação, selecione a região a ser usada.
1. No painel de navegação, escolha **Modelos avaliação**.
1. Selecione o nome do modelo de avaliação a ser modificado.
1. Na seção **Tags** da guia **Visão geral**, escolha **Gerenciar tags**.
1. Adicione ou exclua as tags conforme necessário.
+ Para adicionar uma tag, escolha **Adicionar nova tag** e preencha os campos **Chave** e **Valor**.
+ Para excluir uma tag, escolha **Remove** (Remover).
1. Repita esse processo para cada tag que você deseja adicionar, modificar ou excluir. Escolha **Salvar** para salvar as alterações.
## Trabalhar com tags usando a API
Use as seguintes operações da API do AWS WA Tool para adicionar, atualizar, listar e excluir as tags de seus recursos.
**Suporte à marcação para recursos AWS WA Tool**
| Tarefa | Ação API |
| --- | --- |
| Adicione ou sobrescreva uma ou mais tags. | [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_TagResource.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_TagResource.html) |
| Exclua uma ou mais tags. | [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_UntagResource.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_UntagResource.html) |
| Listar as etiquetas de um recurso. | [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_ListTagsForResource.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_ListTagsForResource.html) |
Algumas ações de criação de recursos permitem especificar tags ao criar o recurso. As ações a seguir são compatíveis com o uso de tags na criação.
| Tarefa | Ação API |
| --- | --- |
| Criar uma workload | [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateWorkload.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateWorkload.html) |
| Importar uma nova lente | [ImportLens](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_ImportLens.html) |
| Criar um perfil | [CreateProfile](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateProfile.html) |
| Criar um modelo de avaliação | [CreateReviewTemplate](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateReviewTemplate.html) |