Marcar recursos do Amazon EC2 - Amazon Elastic Compute Cloud

Marcar recursos do Amazon EC2

Para ajudá-lo a gerenciar instâncias, imagens e outros recursos do Amazon EC2, é possível atribuir seus próprios metadados a cada recurso na forma de tags. As tags permitem categorizar seus recursos da AWS de diferentes formas (como por finalidade, por proprietário ou por ambiente). Isso é útil quando você tem muitos recursos do mesmo tipo — é possível identificar rapidamente um recurso específico baseado nas tags que você atribuiu a ele. Este tópico descreve tags e mostra a você como criá-los.

Atenção

As chaves de tag e seus valores são apresentados por várias chamadas de API diferentes. Negar acesso ao DescribeTags não nega automaticamente acesso às tags apresentadas por outras APIs. Como uma prática recomendada, sugerimos que você não inclua dados confidenciais nas suas tags.

Conceitos básicos de tags

Tag é um rótulo que você atribui a um recurso da AWS. Cada tag consiste de uma chave e um valor opcional, ambos definidos por você.

As tags permitem categorizar seus recursos da AWS de diferentes formas (como por finalidade, por proprietário ou por ambiente). Por exemplo, você pode definir um conjunto de tags para as instâncias do Amazon EC2 da sua conta que lhe ajudem a rastrear o proprietário e o nível do stack de cada instância.

O diagrama a seguir mostra como funciona o uso de tags. Neste exemplo, você atribuiu duas tags a cada uma de suas instâncias — uma tag com a chave Owner e outra com a chave Stack. Cada tag tem também um valor associado.


					Exemplo de tags

Recomendamos que você desenvolva um conjunto de chave de tags que atenda suas necessidades para cada tipo de recurso. Usar um conjunto consistente de chaves de tags facilita para você gerenciar seus recursos. Você pode pesquisar e filtrar os recursos de acordo com as tags que adicionar. Para obter mais informações sobre como implementar uma estratégia eficaz de marcação de recursos, consulte o whitepaper da AWS Práticas recomendadas de marcação.

As tags não têm significado semântico no Amazon EC2 e são interpretadas estritamente como uma sequência dos caracteres. Além disso, as tags não são automaticamente atribuídas aos seus recursos. Você pode editar chaves de tags e valores, e você pode remover as tags de um recurso a qualquer momento. Você pode 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. Se você excluir um recurso, todas as tags do recurso também serão excluídas.

Você pode trabalhar com tags usando o Console de gerenciamento da AWS, a AWS CLI e a API do Amazon EC2.

Se você estiver usando AWS Identity and Access Management (IAM), pode controlar quais usuários na sua conta da AWS têm permissão para criar, editar ou excluir tags. Para obter mais informações, consulte Identity and Access Management para o Amazon EC2.

Marcar recursos

Você pode usar tags na maioria dos recursos do Amazon EC2 que já existem na sua conta. A tabela a seguir lista os recursos compatíveis com o uso de tags.

Se você estiver usando o console do Amazon EC2, poderá aplicar tags aos recursos usando a guia Tags na tela de recursos relevante ou usar a tela Tags. Algumas telas de recursos permitem que você especifique tags para um recurso ao criá-lo; por exemplo, uma tag com uma chave de Name e um valor que você especificar. Na maioria dos casos, o console aplicará as tags imediatamente depois de o recurso ser criado (em vez de durante a criação de recursos). O console pode organizar os recursos de acordo com a tag do Name, mas ela não tem nenhum significado semântico ao serviço do Amazon EC2.

Se você estiver usando a API do Amazon EC2, a AWS CLI ou o AWS SDK, poderá usar a ação CreateTags da API do EC2 para aplicar tags aos recursos existentes. Além disso, 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, nós reverteremos o processo de criação de recursos. Isso garante que os recursos sejam criados com tags ou, então, não criados, e que nenhum recurso seja deixado sem tags. Ao marcar com tags os recursos no momento da criação, você elimina a necessidade de executar scripts personalizados de uso de tags após a criação do recurso.

A tabela a seguir descreve os recursos do Amazon EC2 que podem ser marcados e os recursos que podem ser marcados na criação usando a API do Amazon EC2, a AWS CLI ou um SDK da AWS.

Suporte à marcação para recursos do Amazon EC2
Recurso Compatível com tags Oferece suporte à marcação na criação

AFI

Sim

Sim

AMI

Sim

Não

Tarefa de pacote

Não

Não

Reserva de capacidade

Sim

Sim

Gateway da operadora Sim Sim

Endpoint do Client VPN

Sim

Sim

Rota do Client VPN

Não

Não

Gateway do cliente

Sim

Sim

Host dedicado

Sim

Sim

Reserva de Host dedicado

Sim

Sim

Opção de DHCP

Sim

Sim

Snapshot do EBS

Sim

Sim

Volume do EBS

Sim

Sim

Frota do EC2

Sim

Sim

Gateway da Internet somente de saída

Sim

Sim

Endereços elastic IP (EIPs)

Sim

Não

Aceleradora do Elastic Graphics

Sim

Não

Instância

Sim

Sim

Volumes de armazenamento de instâncias

N/D

N/D

Gateway da Internet

Sim

Sim

Grupo de endereços IP (BYOIP)

Sim

Sim

Par de chaves

Sim

Sim

Modelo de execução

Sim

Sim

Versão do modelo de execução

Não

Não

Gateway local

Sim

Não

Tabela de rotas do gateway local

Sim

Não

Interface virtual do gateway local

Sim

Não

Grupo de interface virtual do gateway local

Sim

Não

Associação de VPC da tabela de rotas do gateway local

Sim

Sim

Associação de grupos de interface virtual da tabela de rotas do gateway local

Sim

Não

gateway NAT

Sim

Sim

Conexão ACL

Sim

Sim

Interface de rede

Sim

Sim

Placement group

Sim

Sim

Lista de prefixos

Sim

Sim

Instância reservada

Sim

Não

Listagem do Instância reservada

Não

Não
Tabela de rotas

Sim

Sim

Solicitação de frota spot

Sim

Sim

Solicitação do Instância spot

Sim

Sim

Grupo de segurança

Sim

Sim

Sub-rede

Sim

Sim
Filtro de espelho de tráfego Sim Sim
Sessão de espelho de tráfego Sim Sim
Destino de espelho de tráfego Sim Sim

Transit gateway

Sim

Sim

Tabela de rotas do Transit Gateway

Sim

Sim

Anexo da VPC do Transit Gateway

Sim

Sim

Gateway privado virtual

Sim

Sim

VPC

Sim

Sim

VPC endpoint

Sim

Sim

Serviço de VPC endpoint

Sim

Sim

Configuração do serviço do VPC endpoint

Sim

Sim

Log do fluxo da VPC

Sim

Sim

Conexão de emparelhamento de VPC

Sim

Sim

Conexão VPN

Sim

Sim

Você pode marcar instâncias e volumes durante a criação usando o assistente de instâncias do Amazon EC2 Launch no console do Amazon EC2. Você pode marcar com tag seus volumes do EBS na criação usando a tela Volumes ou snapshots do EBS usando a tela Snapshots. Se preferir, use as APIs do Amazon EC2 para criação de recursos (por exemplo, RunInstances) para aplicar tags ao criar seu recurso.

Você pode aplicar permissões no nível do recurso com base em tags nas suas políticas do IAM para ações de API do Amazon EC2 que oferecem suporte à marcação durante a criação para implementar controle granular sobre os usuários e grupos que podem marcar recursos na criação. Seus recursos estão devidamente protegidos contra criação — as tags aplicadas imediatamente aos recursos; portanto, todas as permissões em nível de recurso baseadas em tags que controlam o uso de recursos entram imediatamente em vigor. Seus recursos podem ser rastreados e relatados com mais precisão. Você pode obrigar o uso de marcação com tags nos novos recursos e controlar quais chaves e valores de tag são definidos nos seus recursos.

Você também pode aplicar permissões em nível de recurso às ações CreateTags e DeleteTags da API do Amazon EC2 nas suas políticas do IAM, de forma a controlar quais chaves e valores de tags são definidos nos recursos existentes. Para obter mais informações, consulte Exemplo: marcação de recursos.

Para obter mais informações sobre como marcar seus recursos com tags para faturamento, consulte Uso de tags de alocação de custos no Guia do usuário do AWS Billing and Cost Management.

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 tag deve ser exclusiva e pode ter apenas um valor.

  • Comprimento máximo da chave – 128 caracteres Unicode em UTF-8

  • Valor máximo da chave – 256 caracteres Unicode em UTF-8

  • Embora o EC2 permita qualquer caractere em suas tags, outros serviços podem ser mais restritivos. Os caracteres permitidos nos serviços são: letras, números e espaços representáveis em UTF-8 e os seguintes caracteres: + - = . _ : / @.

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

  • O prefixo aws: é reservado para uso da AWS. Não é possível editar nem excluir a chave ou o valor de uma tag quando ela tem uma chave de tag com esse prefixo. As tags com o prefixo aws: não contam para as tags por limite de recurso.

Você não pode encerrar, parar ou excluir um recurso baseado unicamente em suas tags; será preciso especificar o identificador de recursos. Por exemplo, para excluir snapshots marcados com uma chave de tag chamada DeleteMe, você deve usar a ação DeleteSnapshots com os identificadores de recursos dos snapshots, como snap-1234567890abcdef0.

Você pode marcar com tag recursos públicos ou compartilhados, mas as tags que você atribuir só estarão disponíveis para sua conta AWS e não para outras contas com as quais o recurso é compartilhado.

Você não pode marcar com tag todos os recursos. Para obter mais informações, consulte Suporte à marcação para recursos do Amazon EC2.

Marcar recursos para faturamento

Você pode usar tags para organizar sua conta AWS e refletir sua própria estrutura de custos. Para isso, inscreva-se para obter sua conta da AWS com os valores de chave de tags incluídos. Para obter mais informações sobre como configurar um relatório de alocação de custos com tags, consulte Relatório de alocação de custos mensal no Guia do usuário do AWS Billing and Cost Management. Para ver o custo dos recursos combinados, você pode organizar as informações de faturamento com base nos recursos com os mesmos valores da chave da tag. Por exemplo, você pode etiquetar vários recursos com um nome de aplicação específico, e depois organizar suas informações de faturamento para ver o custo total daquela aplicação em vários serviços. Para obter mais informações, consulte Uso de tags de alocação de custos no Guia do usuário do AWS Billing and Cost Management.

nota

Se você tiver acabado de habilitar a criação de relatórios, os dados do mês atual estarão disponíveis para visualização após 24 horas.

Tags de alocação de custos podem indicar quais recursos estão contribuindo para os custos, mas excluí-los ou desativá-los nem sempre reduz custos. Por exemplo, os dados de snapshots consultados por outro snapshot são preservados, mesmo se o snapshot que contém os dados originais for excluído. Para obter mais informações, consulte Volumes e snapshots do Amazon Elastic Block Store no Guia do usuário do AWS Billing and Cost Management.

nota

Os endereços IP elásticos marcados não são exibidos no seu relatório de alocação de custos.

Trabalhar com tags usando o console

Usando o console do Amazon EC2, você pode ver quais tags estão em uso em todos os recursos do Amazon EC2 na mesma Região. Você pode visualizar tags por recurso e por tipo de recurso, e também verificar quantos itens de cada tipo de recurso está associado a uma tag especificada. Você também pode usar o console do Amazon EC2 para aplicar ou remover tags de um ou mais recursos por vez.

Para obter mais informações sobre o uso de filtros ao listar seus recursos, consulte Listagem e filtragem dos recursos.

Para facilidade de uso e melhores resultados, use o Tag Editor no Console de gerenciamento da AWS, que fornece uma forma unificada e central para criar e gerenciar suas tags. Para obter mais informações, consulte Como trabalhar com o Tag Editor no Conceitos básicos do Console de Gerenciamento da AWS.

Exibir tags

Você pode exibir tags de duas maneiras diferentes no console do Amazon EC2. É possível exibir as tags para um recurso individual ou para todos os recursos.

Exibir tags para recursos individuais

Quando você selecionar uma página específica do recurso no console do Amazon EC2, ela exibirá uma lista desses recursos. Por exemplo, se você selecionar Instances (Instâncias) no painel de navegação, o console exibirá uma lista das instâncias do Amazon EC2. Ao selecionar um recurso de uma dessas listas (por exemplo, uma instância), se o recurso é compatível com tags, você pode ver e gerenciá-las. Na maioria das páginas de recursos, é possível visualizar as tags ao selecionar a guia Tags.

Você pode adicionar uma coluna à lista de recursos que mostra todos os valores das tags com a mesma chave. Essa coluna permite que você classifique e filtre a lista de recursos pela tag. Há duas maneiras de adicionar uma coluna nova à lista de recursos para exibir suas tags:

  • Na guia Tags, selecione Mostrar coluna. Uma nova coluna será adicionada ao console.

  • Escolha o ícone de engrenagem Mostrar/ocultar colunas e a caixa de diálogo Mostrar/ocultar colunas, selecione a chave de tags em Suas chaves de tag.

Exibir tags para todos os recursos

Você pode exibir as tags em todos os recursos selecionando Tags no painel de navegação do console do Amazon EC2. A imagem a seguir mostra o painel Tags, que lista todas as tags em uso por tipo de recurso.


						O painel Tags no console do Amazon EC2

Adicionar e excluir tags em um recurso individual

Você pode gerenciar as tags para um recurso individual diretamente pela página de recursos.

Para adicionar uma tag a um recurso individual

  1. Abra o console do Amazon EC2 em https://console.aws.amazon.com/ec2/.

  2. Na barra de navegação, selecione a Região que atende às suas necessidades. Essa escolha é importante, pois alguns recursos do Amazon EC2 podem ser compartilhados entre Regiões, enquanto outros não podem. Para obter mais informações, consulte Localizações de recursos.

  3. No painel de navegação, selecione um tipo de recurso (por exemplo, Instâncias).

  4. Selecione o recurso da lista de recursos e escolha a guia Tags.

  5. Escolha Manage tags (Gerenciar tags), Add tag (Adicionar tag). Insira a chave e o valor da tag. Quando terminar de adicionar tags, selecione Save (Salvar).

Para excluir uma tag de um recurso individual

  1. Abra o console do Amazon EC2 em https://console.aws.amazon.com/ec2/.

  2. Na barra de navegação, selecione a Região que atende às suas necessidades. Essa escolha é importante, pois alguns recursos do Amazon EC2 podem ser compartilhados entre Regiões, enquanto outros não podem. Para obter mais informações, consulte Localizações de recursos.

  3. No painel de navegação, selecione um tipo de recurso (por exemplo, Instâncias).

  4. Selecione o recurso da lista de recursos e escolha a guia Tags.

  5. Selecione Manage tags (Gerenciar tags). Em cada tag, escolha Remove (Remover). Ao finalizar a remoção de tags, escolha Save (Salvar).

Adicionar e excluir tags a um grupo de recursos

Para adicionar uma tag a um grupo de recursos

  1. Abra o console do Amazon EC2 em https://console.aws.amazon.com/ec2/.

  2. Na barra de navegação, selecione a Região que atende às suas necessidades. Essa escolha é importante, pois alguns recursos do Amazon EC2 podem ser compartilhados entre Regiões, enquanto outros não podem. Para obter mais informações, consulte Localizações de recursos.

  3. No painel de navegação, selecione Tags.

  4. Na parte superior do painel de conteúdo, escolha Gerenciar tags.

  5. Em Filter (Filtro), selecione o tipo de recurso (por exemplo, instâncias).

  6. Na lista de recursos, marque a caixa de seleção ao lado de cada recurso.

  7. Em Add Tag (Adicionar tag), insira a chave e o valor da tag e escolha Add Tag (Adicionar tag).

    nota

    Se você adicionar uma nova tag com a mesma chave de uma tag existente, a nova sobrescreverá a tag existente.

Para remover uma tag de um grupo de recursos

  1. Abra o console do Amazon EC2 em https://console.aws.amazon.com/ec2/.

  2. Na barra de navegação, selecione a Região que atende às suas necessidades. Essa escolha é importante, pois alguns recursos do Amazon EC2 podem ser compartilhados entre Regiões, enquanto outros não podem. Para obter mais informações, consulte Localizações de recursos.

  3. No painel de navegação, selecione Tags, Gerenciar tags.

  4. Para ver as tags em uso, selecione o ícone de engrenagem Mostrar/ocultar colunas e, na caixa de diálogo Mostrar/ocultar colunas, selecione as chaves das tags e selecione Fechar.

  5. Em Filter (Filtro), selecione o tipo de recurso (por exemplo, instâncias).

  6. Na lista de recursos, marque a caixa de seleção ao lado de cada recurso.

  7. Em Remove Tag (Remover tag), insira a chave da tag e escolha Remove Tag (Remover tag).

Adicionar uma tag ao executar uma instância

Para adicionar uma tag usando o assistente de execução

  1. Na barra de navegação, selecione a Região da instância. Essa escolha é importante, pois alguns recursos do Amazon EC2 podem ser compartilhados entre Regiões, enquanto outros não podem. Selecione a Região que satisfaz suas necessidades. Para obter mais informações, consulte Localizações de recursos.

  2. Escolha Launch Instance (Executar instância).

  3. A página Choose an Amazon Machine Image (AMI) (Escolher uma Imagem de máquina da Amazon (AMI)) exibe uma lista de configurações básicas denominadas Imagens de máquina da Amazon (AMI). Selecione as AMIs a serem usadas e escolha Selecionar. Para obter mais informações sobre como selecionar uma AMI, consulte Localizar uma AMI.

  4. Na página Configurar detalhes da instância, configure as configurações da instância conforme necessário e selecione Próximo: Adicionar armazenamento.

  5. Na página Adicionar armazenamento, especifique os volumes de armazenamento adicionais para sua instância. Selecione Próximo: Adicionar tags ao concluir.

  6. Na página Adicionar tags, especifique tags da instância, os volumes ou ambos. Escolha Adicionar outra tag para adicionar mais de uma tag à sua instância. Escolha Next: Configure Security Group ao concluir.

  7. Na página Configurar security group, escolha qualquer security group existente que você possui ou deixe o assistente criar um novo security group para você. Selecione Revisar e executar ao concluir.

  8. Examine suas configurações. Quando você estiver satisfeito com suas seleções, escolha Executar. Selecione um par de chaves existente ou crie um novo, selecionando a caixa de confirmação e escolhendo Executar instâncias.

Filtrar uma lista de recursos por tag

Você pode filtrar sua lista de recursos baseados em uma ou mais chaves e valores de tags.

Para filtrar uma lista de recursos por tag

  1. No painel de navegação, selecione um tipo de recurso (por exemplo, Instâncias).

  2. Escolha o campo de pesquisa.

  3. Escolha a chave de tag na lista.

  4. Escolha o valor de tag correspondente na lista.

  5. Quando terminar, remova o filtro.

Para obter mais informações sobre os filtros, consulte Listagem e filtragem dos recursos.

Trabalhar com as tags usando a linha de comando

É possível adicionar tags a muitos recursos do EC2 ao criá-las, usando o parâmetro de especificações de tag para o comando de criação. É possível visualizar as tags de um recurso usando o comando de descrição para o recurso. Também é possível adicionar, atualizar ou excluir tags para seus recursos existentes usando os seguintes comandos.

Tarefa AWS CLI AWS Tools para Windows PowerShell

Adicione ou substitua uma ou mais tags

create-tags

New-EC2Tag

Exclua uma ou mais tags

delete-tags

Remove-EC2Tag

Descreva uma ou mais tags

describe-tags

Get-EC2Tag

Adicionar tags na criação de recursos

Os exemplos a seguir demonstram como aplicar tags ao criar recursos.

A maneira como insere os parâmetros formatados pelo JSON na linha de comando difere dependendo de seu sistema operacional. Linux, macOS ou Unix e Windows PowerShell usam as aspas simples (') para delimitar a estrutura de dados JSON. Omita as únicas citações ao usar os comandos com a linha de comando do Windows. Para obter mais informações, consulte Especificar valores de parâmetro para a AWS Command Line Interface.

exemplo Exemplo: execute uma instância e aplique tags à instância e ao volume

O seguinte comando run-instances inicia uma instância e aplica uma tag com a chave webserver e o valor production à instância. O comando também aplica uma tag com uma chave de cost-center e um valor de cc123 a qualquer volume do EBS criado (neste caso, o volume do dispositivo raiz).

aws ec2 run-instances \ --image-id ami-abc12345 \ --count 1 \ --instance-type t2.micro \ --key-name MyKeyPair \ --subnet-id subnet-6e7f829e \ --tag-specifications 'ResourceType=instance,Tags=[{Key=webserver,Value=production}]' 'ResourceType=volume,Tags=[{Key=cost-center,Value=cc123}]'

Você pode aplicar as mesmas chaves da tag e os mesmos valores aos dois volumes e instâncias durante a execução. O comando a seguir executa uma instância e aplica uma tag com uma chave de cost-center e um valor de cc123 à instância e a qualquer volume do EBS criado.

aws ec2 run-instances \ --image-id ami-abc12345 \ --count 1 \ --instance-type t2.micro \ --key-name MyKeyPair \ --subnet-id subnet-6e7f829e \ --tag-specifications 'ResourceType=instance,Tags=[{Key=cost-center,Value=cc123}]' 'ResourceType=volume,Tags=[{Key=cost-center,Value=cc123}]'

exemplo Exemplo: crie um o volume e aplique uma tag

O comando create-volume cria um volume e aplica duas tags: purpose=production e cost-center=cc123.

aws ec2 create-volume \ --availability-zone us-east-1a \ --volume-type gp2 \ --size 80 \ --tag-specifications 'ResourceType=volume,Tags=[{Key=purpose,Value=production},{Key=cost-center,Value=cc123}]'

Adicionar tags a um recurso existente

Os exemplos a seguir demonstram como adicionar tags a um recurso existente usando o comando create-tags.

exemplo Exemplo: adicionar uma tag a um recurso

O seguinte comando adiciona a tag Stack=production à imagem especificada ou substitui uma tag existente para a AMI na qual a chave de tag é Stack. Se o comando for bem-sucedido, nenhuma saída será retornada.

aws ec2 create-tags \ --resources ami-78a54011 \ --tags Key=Stack,Value=production

exemplo Exemplo: adicionar tags a vários recursos

Este exemplo adiciona (ou substitui) duas tags para uma AMI e uma instância. Uma das tags contém apenas uma chave (webserver), sem valor (definimos o valor como uma string vazia). A outra tag consiste em uma chave (stack) e um valor (Production). Se o comando for bem-sucedido, nenhuma saída será retornada.

aws ec2 create-tags \ --resources ami-1a2b3c4d i-1234567890abcdef0 \ --tags Key=webserver,Value= Key=stack,Value=Production

exemplo Exemplo: adicionar tags com caracteres especiais

Este exemplo adiciona a tag [Group]=test a uma instância. Os colchetes ([ e ]) são caracteres especiais, que devem ser recuados.

Se você estiver usando o Linux ou o OS X, para recuar os caracteres especiais, coloque o elemento com o caractere especial entre aspas duplas (") e coloque toda a estrutura de chave e valor entre aspas simples (').

aws ec2 create-tags \ --resources i-1234567890abcdef0 \ --tags 'Key="[Group]",Value=test'

Se você estiver usando o Windows, para recuar os caracteres especiais, coloque o elemento que tem caracteres especiais entre aspas duplas (") e preceda cada caractere de aspas duplas com uma barra invertida (\) da seguinte maneira:

aws ec2 create-tags ^ --resources i-1234567890abcdef0 ^ --tags Key=\"[Group]\",Value=test

Se você estiver usando o Windows PowerShell, para recuar os caracteres especiais, coloque o valor que tem caracteres especiais entre aspas duplas ("), preceda cada caractere de aspas duplas com uma barra invertida (\) e coloque toda a estrutura de chave e valor entre aspas simples (') da seguinte maneira:

aws ec2 create-tags ` --resources i-1234567890abcdef0 ` --tags 'Key=\"[Group]\",Value=test'

Descrever recursos marcados

Os exemplos a seguir mostram como usar filtros com describe-instances para visualizar instâncias com tags específicas. Todos os comandos “describe” do EC2 usam essa sintaxe para filtrar por tag em um único tipo de recurso. Como alternativa, é possível usar o comando describe-tags para filtrar por tag entre os tipos de recursos do EC2.

exemplo Exemplo: descreva as instâncias com a chave de tags especificada

O comando a seguir descreve as instâncias com a tag Stack, independentemente do valor da tag.

aws ec2 describe-instances \ --filters Name=tag-key,Values=Stack

exemplo Exemplo: descreva as instâncias com a tag especificada

O comando a seguir descreve as instâncias com a tag Stack=production.

aws ec2 describe-instances \ --filters Name=tag:Stack,Values=production

exemplo Exemplo: descreva as instâncias com o valor de tag especificado

O comando a seguir descreve as instâncias com uma tag com o valor production, independentemente da chave da tag.

aws ec2 describe-instances \ --filters Name=tag-value,Values=production

exemplo Exemplo: descrever todos os recursos do EC2 com a tag especificada

O comando a seguir descreve todos os recursos do EC2 com a tag Stack=Test.

aws ec2 describe-tags \ --filters Name=key,Values=Stack Name=value,Values=Test

Adicionar tags a um recurso usando o CloudFormation

Com tipos de recursos do Amazon EC2, você especifica tags usando uma propriedade Tags ou TagSpecifications.

Os exemplos a seguir adicionam a tag Stack=Production ao AWS።EC2።Instance usando a propriedade Tags.

exemplo Exemplo: tags em YAML

Tags: - Key: "Stack" Value: "Production"

exemplo Exemplo: tags em JSON

"Tags": [ { "Key": "Stack", "Value": "Production" } ]

Os exemplos a seguir adicionam a tag Stack=Production ao AWS::EC2::LaunchTemplate LaunchTemplateData usando a propriedade TagSpecifications.

exemplo Exemplo: TagSpecifications em YAML

TagSpecifications: - ResourceType: "instance" Tags: - Key: "Stack" Value: "Production"

exemplo Exemplo: TagSpecifications em JSON

"TagSpecifications": [ { "ResourceType": "instance", "Tags": [ { "Key": "Stack", "Value": "Production" } ] } ]