Lançamos uma nova versão do Well-Architected Framework. Também adicionamos lentes novas e atualizadas ao Catálogo de Lentes. Saiba mais
Marcando seus Recursos AWS WA Tool
Para ajudar no gerenciamento de recursos 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.
Conteúdo
Conceitos Básicos de Tags
Uma tag um rótulo atribuído a um recurso AWS. Cada tag consiste em uma chave e um valor opcional, ambos definidos por você.
As tags permitem categorizar seus recursos 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 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 a 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 AWS Management Console, AWS CLI e API de 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 AWS WA Tool, AWS CLI ou SDK AWS, é possível aplicar tags a novos recursos por meio do parâmetro tags
na ação API relevante ou, para recursos existentes, da ação API TagResource
. Para mais informações, consulte TagResource.
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.
Recurso | Compatível com tags | Compatível com a propagação de tags | Compatível com o uso de tags na criação (API AWS WA Tool, AWS CLI e SDK 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 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 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
Faça login no AWS Management Console e abra o console do AWS Well-Architected Tool em https://console.aws.amazon.com/wellarchitected/
. -
Na barra de navegação, selecione a região a ser usada.
-
No painel de navegação, selecione Workloads.
-
Selecione a workload a ser modificada e escolha Propriedades.
-
Na seção Tags, escolha Gerenciar tags.
-
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).
-
-
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
Faça login no AWS Management Console e abra o console do AWS Well-Architected Tool em https://console.aws.amazon.com/wellarchitected/
. -
Na barra de navegação, selecione a região a ser usada.
-
No painel de navegação, escolha Lentes personalizadas.
-
Selecione o nome da lente personalizada a ser modificada.
-
Na seção Tags da guia Visão geral, escolha Gerenciar tags.
-
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).
-
-
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
Faça login no AWS Management Console e abra o console do AWS Well-Architected Tool em https://console.aws.amazon.com/wellarchitected/
. -
Na barra de navegação, selecione a região a ser usada.
-
No painel de navegação, escolha Perfis.
-
Selecione o nome do perfil a ser modificado.
-
Na seção Tags da guia Visão geral, escolha Gerenciar tags.
-
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).
-
-
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
Faça login no AWS Management Console e abra o console do AWS Well-Architected Tool em https://console.aws.amazon.com/wellarchitected/
. -
Na barra de navegação, selecione a região a ser usada.
-
No painel de navegação, escolha Modelos avaliação.
-
Selecione o nome do modelo de avaliação a ser modificado.
-
Na seção Tags da guia Visão geral, escolha Gerenciar tags.
-
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).
-
-
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.
Tarefa | Ação API |
---|---|
Adicione ou sobrescreva uma ou mais tags. |
|
Exclua uma ou mais tags. |
|
Listar as etiquetas de um recurso. |
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 | CreateWorkload |
Importar uma nova lente | |
Criar um perfil | |
Criar um modelo de avaliação |