Marcar documentos do Systems Manager

Os tópicos desta seção descrevem como trabalhar com tags em documentos do Systems Manager (documentos do SSM).

Criar documentos com tags

É possível adicionar tags a documentos personalizados do SSM no momento da criação.

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

• Criar um documento SSM (console)

• Criar um documento do SSM (linha de comando)

Adicionar tags a documentos existentes

É possível adicionar tags a documentos personalizados do SSM que você possui usando o console do Systems Manager ou a linha de comando.

Tópicos

• Adicionar tags a um documento do SSM existente (console)
• Adicionar tags a um documento do SSM existente (linha de comando)

Adicionar tags a um documento do SSM existente (console)

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

2. No painel de navegação, escolha Documents.

3. Escolha a guia De minha propriedade.

4. Escolha o nome do documento ao qual deseja adicionar tags e escolha a guia Detalhes.

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

6. Escolha Salvar.

Adicionar tags a um documento do SSM existente (linha de comando)

Para adicionar tags a um documento do SSM existente (linha de comando)

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

   Linux & macOS

   aws ssm list-documents

   Windows

   aws ssm list-documents

   PowerShell

   Get-SSMDocumentList

   Observe o nome de um documento que você deseja marcar.

2. Execute o seguinte comando para marcar um documento. 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 "Document" \
       --resource-id "document-name" \
       --tags "Key=tag-key,Value=tag-value"

   Windows

   aws ssm add-tags-to-resource ^
       --resource-type "Document" ^
       --resource-id "document-name" ^
       --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 "Document" `
       -ResourceId "document-name" `
       -Tag $tag `
       -Force

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

3. Execute o seguinte comando para verificar as tags do documento.

   Linux & macOS

   aws ssm list-tags-for-resource \
       --resource-type "Document" \
       --resource-id "document-name"

   Windows

   aws ssm list-tags-for-resource ^
       --resource-type "Document" ^
       --resource-id "document-name"

   PowerShell

   Get-SSMResourceTag `
       -ResourceType "Document" `
       -ResourceId "document-name"

Remover tags de documentos do SSM

É possível usar o console do Systems Manager ou a linha de comando para remover tags de documentos do SSM.

Tópicos

• Remover tags de documentos do SSM (console)
• Remover tags de documentos do SSM (linha de comando)

Remover tags de documentos do SSM (console)

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

2. No painel de navegação, escolha Documents.

3. Escolha a guia De minha propriedade.

4. Escolha o nome do documento do qual deseja remover as tags e escolha a guia Detalhes.

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

6. Escolha Salvar.

Remover tags de documentos do SSM (linha de comando)

1. Usando sua ferramenta de linha de comando preferencial, execute o comando a seguir para listar os documentos na sua conta.

   Linux & macOS

   aws ssm list-documents

   Windows

   aws ssm list-documents

   PowerShell

   Get-SSMDocumentList

   Observe o nome de um documento do qual você deseja remover as tags.

2. Execute o comando a seguir para remover as tags de um documento. 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 "Document" \
       --resource-id "document-name" \
       --tag-key "tag-key"

   Windows

   aws ssm remove-tags-from-resource ^
       --resource-type "Document" ^
       --resource-id "document-name" ^
       --tag-key "tag-key"

   PowerShell

   Remove-SSMResourceTag `
       -ResourceId "document-name" `
       -ResourceType "Document" `
       -TagKey "tag-key" `
       -Force

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

3. Execute o seguinte comando para verificar as tags do documento.

   Linux & macOS

   aws ssm list-tags-for-resource \
       --resource-type "Document" \
       --resource-id "document-name"

   Windows

   aws ssm list-tags-for-resource ^
       --resource-type "Document" ^
       --resource-id "document-name"

   PowerShell

   Get-SSMResourceTag `
       -ResourceType "Document" `
       -ResourceId "document-name"