Marcar parâmetros do Systems Manager - AWS Systems Manager

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Marcar parâmetros do Systems Manager

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

Criar parâmetros com tags

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

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

Adicionar tags a parâmetros existentes

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

Adicionar tags a um parâmetro existente (console)

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

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

    -ou-

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

  3. Escolha o nome de um parâmetro que você já criou e, em seguida, escolha 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.

    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.

    parameter-name é o nome do SSM parâmetro que você deseja marcar.

    tag-key é o nome de uma chave personalizada que você fornece. Por exemplo, Environment ou Project.

    tag-value é o conteúdo personalizado para o valor que você deseja fornecer para essa chave. Por exemplo, Production ou Q321.

  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 para 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.

    $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

    parameter-name o nome do SSM parâmetro que você deseja marcar.

    tag-key é o nome de uma chave personalizada que você fornece. Por exemplo, Environment ou Project.

    tag-value é o conteúdo personalizado para o valor que você deseja fornecer para essa chave. Por exemplo, Production ou Q321.

  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 Systems Manager

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

Remover tags de parâmetros do Systems Manager (console)

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

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

    -ou-

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

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

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

  5. Escolha Save (Salvar).

Remover tags de parâmetros do Systems Manager (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
    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.

    Linux
    aws ssm remove-tags-from-resource \ --resource-type "Parameter" \ --resource-id "parameter-name" \ --tagkey "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

    parameter-name é o nome do SSM parâmetro do qual você deseja remover uma tag.

    tag-key é o nome de uma chave atribuída ao parâmetro. Por exemplo, Environment ou Quarter.

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

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

    Linux
    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"