Marcar recursos do AWS WA Tool

Para ajudar você a gerenciar os recursos do AWS WA Tool, é possível atribuir seus próprios metadados a cada recurso na forma de tags. Este tópico descreve as etiquetas e mostra como criá-las.

Conceitos básicos de tags

Uma etiqueta é um rótulo atribuído a um recurso da AWS. Cada etiqueta consiste em uma chave e um valor opcional, ambos definidos por você.

As tags permitem categorizar os recursos da AWS, por exemplo, finalidade, proprietário ou ambiente. Quando você tem muitos recursos do mesmo tipo; é possível identificar rapidamente um recurso específico com base nas tags que você atribuiu 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 o nível da pilha de cada serviço. Recomendamos planejar um conjunto consistente de chaves de etiquetas para cada tipo de recurso.

Além disso, as tags não são automaticamente atribuídas aos recursos. Depois de adicionar uma tag, você pode editar as chaves e os valores das tags ou remover tags de um recurso a qualquer momento. Se você excluir um recurso, todas as tags do recurso também serão excluídas.

As tags não têm significado semântico no AWS WA Tool e são interpretadas estritamente como uma sequência dos caracteres. É possível definir o valor de uma tag a uma string vazia, mas não pode configurar o valor de um tag como nula. Se você adicionar uma tag que tenha a mesma chave de uma tag existente nesse recurso, o novo valor substituirá o antigo.

Você pode trabalhar com tags usando o AWS Management Console, a 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.

Marcar recursos da 

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 cargas de trabalho existentes, você pode aplicar tags na guia Propriedades. Para lentes personalizadas, perfis e modelos de revisão existentes, você pode aplicar tags na guia Visão geral.

Se você estiver usando a API do AWS WA Tool, a AWS CLI ou um AWS SDK, será possível aplicar tags a novos recursos usando o parâmetro tags na ação da API relevante ou, para recursos existentes, usar a ação da API TagResource. Para obter mais informações, consulte TagResource.

Algumas ações de criação de recursos permitem que você especifique tags para um recurso quando ele é criado. Se as tags não puderem ser aplicadas durante a criação dos recursos, haverá falha no processo de criação de recursos. Isso garante que os recursos que você pretende marcar na criação sejam criados com as tags especificadas ou não sejam criados. Se você marcar 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 do AWS WA Tool que podem ser marcados com tags e os recursos que podem ser marcados na criação.

Suporte à marcação para recursos do AWS WA Tool
Recurso	Compatível com tags	Oferece suporte à propagação de tags	Compatível com o uso de tags na criação (API do AWS WA Tool, AWS CLI e AWS SDK)
Cargas de trabalho do AWS WA Tool	Sim	Não	Sim
AWS WA ToolLentes personalizadas	Sim	Não	Sim
AWS WA ToolPerfis do	Sim	Não	Sim
modelos de revisão do AWS WA Tool	Sim	Não	Sim

Restrições de tags

As restrições básicas a seguir se aplicam às tags:

• Número máximo de tags por recurso: 50

• Em todos os recursos, cada chave de etiqueta deve ser exclusiva e pode ter 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

• Se seu esquema de marcação for usado em vários serviços e recursos da AWS, lembre-se de que outros serviços podem ter restrições nos caracteres permitidos. Em geral, os caracteres permitidos são: letras, números, espaços representáveis em UTF-8 e os seguintes caracteres: + - = . _ : / @.

• As chaves e os valores de tags diferenciam maiúsculas de minúsculas.

• Não use aws:, AWS: nem qualquer combinação de letras maiúsculas e minúsculas dessas strings como um prefixo para chaves ou valores, pois são reservadas para uso da AWS. Você não pode editar nem excluir chaves nem valores de etiquetas com esse prefixo. As tags com esse prefixo não contam nos limites de tags por recurso.

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

Adicionar e excluir tags em um recurso individual

O AWS WA Tool permite adicionar ou excluir tags associadas aos seus recursos diretamente da guia Propriedades para uma carga de trabalho e da guia Visão geral para lentes personalizadas, perfis e modelos de revisão.

Para adicionar ou excluir uma tag em uma carga de trabalho

1. Faça login no AWS Management Console e abra o console do AWS Well-Architected Tool Billing em https://console.aws.amazon.com/billing/.

2. Na barra de navegação, selecione a região a ser usada.

3. No painel de navegação, selecione Cargas de trabalho.

4. Selecione a carga de trabalho a ser modificada e escolha Propriedades.

5. Na seção Tags, escolha Manage tags (Gerenciar tags).

6. Adicione ou exclua suas tags conforme necessário.

   • Para adicionar uma nova tag, escolha Add new tag (Adicionar nova tag) e insira a chave e o valor da tag.

   • Para excluir uma tag, escolha Remove (Remover).

7. Repita esse processo para cada tag que você deseja adicionar ou excluir. Escolha Save (Salvar) para salvar as alterações.

Para adicionar ou excluir uma tag em uma lente personalizada

1. Faça login no AWS Management Console e abra o console do AWS Well-Architected Tool Billing em https://console.aws.amazon.com/billing/.

2. Na barra de navegação, selecione a região a ser usada.

3. No painel de navegação, escolha Lentes personalizadas.

4. Selecione o nome da lente personalizada a ser modificada.

5. Na seção Tags da guia Visão geral, escolha Gerenciar tags.

6. Adicione ou exclua suas tags conforme necessário.

   • Para adicionar uma nova tag, escolha Add new tag (Adicionar nova tag) e insira a chave e o valor da tag.

   • Para excluir uma tag, escolha Remove (Remover).

7. Repita esse processo para cada tag que você deseja adicionar ou excluir. Escolha Save (Salvar) para salvar as alterações.

Para adicionar ou excluir uma tag em um perfil

1. Faça login no AWS Management Console e abra o console do AWS Well-Architected Tool Billing em https://console.aws.amazon.com/billing/.

2. Na barra de navegação, selecione a região a ser usada.

3. No painel de navegação, escolha Perfis.

4. Selecione o nome do perfil a ser modificado.

5. Na seção Tags da guia Visão geral, escolha Gerenciar tags.

6. Adicione ou exclua suas tags conforme necessário.

   • Para adicionar uma nova tag, escolha Add new tag (Adicionar nova tag) e insira a chave e o valor da tag.

   • Para excluir uma tag, escolha Remove (Remover).

7. Repita esse processo para cada tag que você deseja adicionar ou excluir. Escolha Save (Salvar) para salvar as alterações.

Para adicionar ou excluir uma tag em um modelo de revisão

1. Faça login no AWS Management Console e abra o console do AWS Well-Architected Tool Billing em https://console.aws.amazon.com/billing/.

2. Na barra de navegação, selecione a região a ser usada.

3. No painel de navegação, escolha Revisar modelos.

4. Selecione o nome do modelo de revisão a ser modificado.

5. Na seção Tags da guia Visão geral, escolha Gerenciar tags.

6. Adicione ou exclua suas tags conforme necessário.

   • Para adicionar uma nova tag, escolha Add new tag (Adicionar nova tag) e insira a chave e o valor da tag.

   • Para excluir uma tag, escolha Remove (Remover).

7. Repita esse processo para cada tag que você deseja adicionar ou excluir. Escolha Save (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 do AWS WA Tool
Tarefa	Ação de API
Adicione ou sobrescreva uma ou mais tags.	TagResource
Exclua uma ou mais tags.	UntagResource
Listar as etiquetas de um recurso.	ListTagsForResource

Algumas ações de criação de recursos permitem especificar as 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 de API
Criar uma carga de trabalho	CreateWorkload
Importar uma nova lente	ImportLens
Como criar um perfil do	CreateProfile
Criar um modelo de revisão	CreateReviewTemplate