Marcar parâmetros do Systems Manager

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

Criar parâmetros com tags

É possível adicionar tags a parâmetros do SSM no momento da criação.

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

• Crie um parâmetro do Systems Manager (console)

• Crie um parâmetro do Systems Manager (AWS CLI)

• Crie um parâmetro do Systems Manager (Tools for Windows PowerShell)

Adicionar tags a parâmetros existentes

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

Tópicos

• Adicionar tags a um parâmetro existente (console)
• Adicionar tags a um parâmetro existente (AWS CLI)
• Adicionar tags a um parâmetro existente (AWS Tools for PowerShell)

Adicionar tags a um parâmetro existente (console)

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

2. No painel de navegação, escolha Parameter Store.

   - ou -

   Se a página inicial do AWS Systems Manager abrir primeiro, escolha o ícone de menu ( ) para abrir o painel de navegação e escolha Parameter Store.

3. Escolha o nome de um parâmetro que você já tenha criado e, em seguida, a guia Tags.

4. Na primeira caixa, insira uma chave para a tag, como Environment.

5. Na segunda caixa, insira um valor para a tag, como Test.

6. Escolha Save (Salvar).

Adicionar tags a um parâmetro existente (AWS CLI)

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

   aws ssm describe-parameters

   Anote o nome de um parâmetro que você deseja marcar.

2. Execute o seguinte comando para marcar um parâmetro. Substitua cada espaço reservado para recurso de exemplo por suas próprias informações.

   aws ssm add-tags-to-resource \
       --resource-type "Parameter" \
       --resource-id "parameter-name" \
       --tags "Key=tag-key,Value=tag-value"

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

3. Execute o seguinte comando para verificar as tags de parâmetros.

   aws ssm list-tags-for-resource --resource-type "Parameter" --resource-id "parameter-name"

Adicionar tags a um parâmetro existente (AWS Tools for PowerShell)

1. Execute o seguinte comando para listar os parâmetros que você pode marcar.

   Get-SSMParameterList

2. Execute os seguintes comandos para marcar um parâmetro. Substitua cada espaço reservado para recurso de exemplo por suas próprias informações.

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

   $tag.Key = "tag-key"

   $tag.Value = "tag-value"

   Add-SSMResourceTag `
       -ResourceType "Parameter" `
       -ResourceId "parameter-name" `
       -Tag $tag `
       -Force

3. Execute o seguinte comando para verificar as tags de parâmetros.

   Get-SSMResourceTag `
       -ResourceType "Parameter" `
       -ResourceId "parameter-name"

Remover tags de parâmetros do SSM

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

Tópicos

• Remover tags de parâmetros do SSM (console)
• Remover tags de parâmetros do SSM (linha de comando)

Remover tags de parâmetros do SSM (console)

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

2. No painel de navegação, escolha Parameter Store.

   - ou -

   Se a página inicial do AWS Systems Manager abrir primeiro, escolha o ícone de menu ( ) para abrir o painel de navegação e escolha Parameter Store.

3. Escolha o nome do parâmetro do qual deseja remover tags e escolha a guia Tags.

4. Escolha Remover ao lado do par de tags que você não precisa mais.

5. Escolha Save (Salvar).

Remover tags de parâmetros do SSM (linha de comando)

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

   Linux & macOS

   aws ssm describe-parameters

   Windows

   aws ssm describe-parameters

   PowerShell

   Get-SSMParameterList

   Observe o nome de um parâmetro do qual você deseja remover as tags.

2. Execute o comando a seguir para remover as tags de um parâmetro. 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 "Parameter" \
       --resource-id "parameter-name" \
       --tag-key "tag-key"

   Windows

   aws ssm remove-tags-from-resource ^
       --resource-type "Parameter" ^
       --resource-id "parameter-name" ^
       --tag-key "tag-key"

   PowerShell

   Remove-SSMResourceTag
       -ResourceId "parameter-name"
       -ResourceType "Parameter"
       -TagKey "tag-key

   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 "Parameter" \
       --resource-id "parameter-name"

   Windows

   aws ssm list-tags-for-resource ^
       --resource-type "Parameter" ^
       --resource-id "parameter-name"

   PowerShell

   Get-SSMResourceTag `
       -ResourceType "Parameter" `
       -ResourceId "parameter-name"