Marcar nós gerenciados

Os tópicos desta seção descrevem como trabalhar com tags em nós gerenciados.

Um nó gerenciado é qualquer máquina configurada para o AWS Systems Manager. Isso inclui instâncias do Amazon Elastic Compute Cloud (Amazon EC2) e máquinas que não são do EC2 em um ambiente híbrido e multinuvem configurado para o Systems Manager.

As instruções neste tópico são aplicáveis a qualquer máquina que esteja sendo gerenciada com o Systems Manager.

Criar ou ativar nós gerenciados com tags

É possível adicionar tags a instâncias do EC2 no momento da criação. É possível adicionar tags a servidores on-premises e máquinas virtuais (VMs) no momento em que ativá-los.

Para obter informações, consulte os seguintes tópicos:

• Para instâncias do EC2, consulte Marcar recursos do Amazon EC2 no Guia do usuário do Amazon EC2. (O conteúdo se aplica às instâncias do EC2 para Linux e para Windows)

• Para servidores e VMs on-premises, consulte Criar uma ativação híbrida para registrar nós com o Systems Manager.

Adicionar tags a nós gerenciados existentes

É possível adicionar tags aos nós gerenciados usando o console do Systems Manager ou a linha de comando.

Tópicos

• Adicionar tags a um nó gerenciado existente (console)
• Adicionar tags a um nó gerenciado existente (linha de comando)

Adicionar tags a um nó gerenciado existente (console)

1. Abra o console AWS Systems Manager em https://console.aws.amazon.com/systems-manager/.

2. No painel de navegação, escolha Fleet Manager.

3. Selecione o ID do nó gerenciado ao qual deseja adicionar tags e escolha a guia Tags (Etiquetas).

   nota

   Se um nó gerenciado que você espera ver não estiver listado, consulte Solução de problemas de disponibilidade do nó gerenciado para obter dicas de solução de problemas.

4. Na seção Tags, escolha Editar e adicione um ou mais pares de tags chave/valor.

5. Escolha Salvar.

Adicionar tags a um nó gerenciado existente (linha de comando)

Para adicionar tags a um nó gerenciado existente (linha de comando)

1. Usando sua ferramenta de linha de comando preferencial, execute o comando a seguir para visualizar a lista de nós gerenciados que você pode marcar.

   Linux & macOS

   aws ssm describe-instance-information

   Windows

   aws ssm describe-instance-information

   PowerShell

   Get-SSMInstanceInformation

   Anote o ID de um nó gerenciado que você quiser marcar.

   nota

   As máquinas que não são do EC2 registradas para uso com o Systems Manager em um ambiente híbrido e multinuvem começam com mi-, por exemplo, mi-0471e04240EXAMPLE. As instâncias do EC2 têm IDs que começam com i-, como i-02573cafcfEXAMPLE.

2. Execute o comando a seguir para marcar um nó gerenciado. Substitua cada espaço reservado para recurso de exemplo por suas próprias informações.

   Linux & macOS

   aws ssm add-tags-to-resource \
       --resource-type "ManagedInstance" \
       --resource-id "instance-id" \
       --tags Key=tag-key,Value=tag-value  

   Windows

   aws ssm add-tags-to-resource ^
       --resource-type "ManagedInstance" ^
       --resource-id "instance-id" ^
       --tags "Key=tag-key,Value=tag-value"

   PowerShell

   $tag = New-Object Amazon.SimpleSystemsManagement.Model.Tag

   $tag.Key = "tag-key"

   $tag.Value = "tag-value"

   Add-SSMResourceTag `
       -ResourceType "ManagedInstance" `
       -ResourceId "instance-id" `
       -Tag $tag `
       -Force

   Se for bem-sucedido, o comando não mostrará uma saída.

3. Execute o comando a seguir para verificar as tags do nó gerenciado.

   Linux & macOS

   aws ssm list-tags-for-resource \
       --resource-type "ManagedInstance" \
       --resource-id "instance-id"

   Windows

   aws ssm list-tags-for-resource ^
       --resource-type "ManagedInstance" ^
       --resource-id "instance-id"

   PowerShell

   Get-SSMResourceTag `
       -ResourceType "ManagedInstance" `
       -ResourceId "instance-id"

Remover tags dos nós gerenciados

É possível usar o console do Systems Manager ou a linha de comando para remover tags dos nós gerenciados.

Tópicos

• Remover tags dos nós gerenciados (console)
• Remover tags dos nós gerenciados (linha de comando)

Remover tags dos nós gerenciados (console)

1. Abra o console AWS Systems Manager em https://console.aws.amazon.com/systems-manager/.

2. No painel de navegação, escolha Fleet Manager.

3. Escolha o nome do nó gerenciado do qual deseja remover tags e escolha a guia Tags (Etiquetas).

4. Na seção Tags, escolha Editar e Remover ao lado do par de tags que você não precisa mais.

5. Escolha Salvar.

Remover tags dos nós gerenciados (linha de comando)

1. Usando sua ferramenta da linha de comando preferencial, execute o comando a seguir para listar os nós gerenciados na sua conta.

   Linux & macOS

   aws ssm describe-instance-information

   Windows

   aws ssm describe-instance-information

   PowerShell

   Get-SSMInstanceInformation

   Anote o nome de uma instância gerenciada da qual você deseja remover tags.

2. Execute o comando a seguir para remover tags de um nó gerenciado. Substitua cada espaço reservado para recurso de exemplo por suas próprias informações.

   Linux & macOS

   aws ssm remove-tags-from-resource \
       --resource-type "ManagedInstance" \
       --resource-id "instance-id" \
       --tag-key "tag-key"

   Windows

   aws ssm remove-tags-from-resource ^
       --resource-type "ManagedInstance" ^
       --resource-id "instance-id" ^
       --tag-key "tag-key"

   PowerShell

   Remove-SSMResourceTag `
       -ResourceId "instance-id" `
       -ResourceType "ManagedInstance" `
       -TagKey "tag-key" `
       -Force

   Se for bem-sucedido, o comando não mostrará uma saída.

3. Execute o comando a seguir para verificar as tags do nó gerenciado.

   Linux & macOS

   aws ssm list-tags-for-resource \
       --resource-type "ManagedInstance" \
       --resource-id "instance-id"

   Windows

   aws ssm list-tags-for-resource ^
       --resource-type "ManagedInstance" ^
       --resource-id "instance-id"

   PowerShell

   Get-SSMResourceTag `
       -ResourceType "ManagedInstance" `
       -ResourceId "instance-id"