Adicionar e remover tags para recursos do Amazon EC2

Ao criar um recurso do Amazon EC2, como uma instância do Amazon EC2, você pode especificar as tags a serem adicionadas ao recurso. Você também pode usar o console do Amazon EC2 para exibir as tags de um recurso específico do Amazon EC2. Você também pode adicionar ou remover tags de um recurso existente do Amazon EC2.

É possível usar o Editor de tags no console do AWS Resource Groups para visualizar, adicionar ou remover tags em todos os seus recursos da AWS em todas as regiões. É possível aplicar ou remover tags de vários tipos de recursos ao mesmo tempo. Para obter mais informações, consulte o Guia do usuário de recursos da AWS para marcação.

Adicionar tags usando o console

É possível adicionar tags a um recurso existente diretamente na página de um recurso.

Para adicionar tags a um recurso existente

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

2. Na barra de navegação, selecione a região na qual o recurso está localizado.

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

4. Selecione o recurso na lista.

5. Na guia Tags, selecione Gerenciar tags.

6. Escolha Adicionar nova tag e insira uma chave e um valor para a tag.

7. Escolha Salvar.

Adicionar tags usando a AWS CLI

É possível adicionar tags ao criar um recurso ou a um recurso existente.

Para adicionar uma tag durante a criação de recurso

Use a opção -tag-specifications para marcar um recurso com tag na criação. A especificação de tag requer o tipo de recurso a ser marcado, a chave e o valor da tag. O exemplo a seguir cria uma tag e a adiciona a uma especificação de tag.

--tag-specifications 'ResourceType=instance,Tags=[{Key=stack,Value=production}]'

Para adicionar uma tag a um recurso existente

Os exemplos a seguir demonstram como adicionar tags a recursos existentes 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-0abcdef1234567890 \
    --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-0abcdef1234567890 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'

Adicionar tags usando PowerShell

É possível adicionar tags ao criar um recurso ou a um recurso existente.

Para adicionar uma tag durante a criação de recurso

Use o parâmetro -TagSpecification para marcar um recurso com tag na criação. A especificação de tag requer o tipo de recurso a ser marcado, a chave e o valor da tag. O exemplo a seguir cria uma tag e a adiciona a uma especificação de tag.

$tag = @{Key="stack"; Value="production"}
$tagspec = new-object Amazon.EC2.Model.TagSpecification
$tagspec.ResourceType = "instance"
$tagspec.Tags.Add($tag)

O exemplo a seguir especifica essa tag no parâmetro -TagSpecification.

-TagSpecification $tagspec

Para adicionar uma tag a um recurso existente

Use o cmdlet New-EC2Tag. Você precisa especificar o recurso, a chave e o valor da tag.

New-EC2Tag `
    -Resource i-1234567890abcdef0 `
    -Tag @{Key="purpose"; Value="production"}

Adicionar tags 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"
            }
        ]
    }
]