Marcar janelas de manutenção - AWS Systems Manager
Criar janelas de manutenção com tagsAdicionar tags às janelas de manutenção existentesRemover tags das janelas de manutenção

Marcar janelas de manutenção

Os tópicos desta seção descrevem como trabalhar com tags nas janelas de manutenção.

Criar janelas de manutenção com tags

É possível adicionar tags às janelas de manutenção no momento em que as cria.

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

Adicionar tags às janelas de manutenção existentes

É possível adicionar tags às janelas de manutenção que você possui usando o console do AWS Systems Manager ou a linha de comando.

Adicionar tags a uma janela de manutenção existente (console)

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

  2. No painel de navegação, escolha Maintenance Windows.

  3. Escolha o nome de uma janela de manutenção que você já criou e escolha as guias Tags.

  4. Escolha Editar tags e Adicionar tag.

  5. Em Chave, insira uma chave para a tag, como Environment.

  6. Em Valor, insira um valor para a tag, como Test.

  7. Escolha Salvar alterações.

Adicionar tags a uma janela de manutenção existente (AWS CLI)

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

    aws ssm describe-maintenance-windows

    Observe o ID de uma janela de manutenção que você deseja marcar.

  2. Execute o comando a seguir para marcar uma janela de manutenção. 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 "MaintenanceWindow" \
    --resource-id "window-id" \
    --tags "Key=tag-key,Value=tag-value"
    Windows
    aws ssm add-tags-to-resource ^
    --resource-type "MaintenanceWindow" ^
    --resource-id "window-id" ^
    --tags "Key=tag-key,Value=tag-value"

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

  3. Execute o comando a seguir para verificar as tags da janela de manutenção.

    Linux & macOS
    aws ssm list-tags-for-resource \
    --resource-type "MaintenanceWindow" \
    --resource-id "window-id"
    Windows
    aws ssm list-tags-for-resource ^
    --resource-type "MaintenanceWindow" ^
    --resource-id "window-id"

Marcar uma janela de manutenção (AWS Tools for PowerShell)

  1. Execute o comando a seguir para listar as janelas de manutenção que você pode marcar.

    Get-SSMMaintenanceWindow

  2. Execute os comandos a seguir para marcar uma janela de manutenção.

    $tag = New-Object Amazon.SimpleSystemsManagement.Model.Tag
    $tag.Key = "tag-key"
    $tag.Value = "tag-value"
    Add-SSMResourceTag `
    -ResourceType "MaintenanceWindow" `
    -ResourceId "window-id" `
    -Tag $tag

    window-id é o ID da janela de manutenção 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 comando a seguir para verificar as tags da janela de manutenção.

    Get-SSMResourceTag `
    -ResourceType "MaintenanceWindow" `
    -ResourceId "window-id"

Remover tags das janelas de manutenção

É possível usar o console do Systems Manager ou a linha de comando para remover tags das janelas de manutenção.

Remover tags das janelas de manutenção (console)

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

  2. No painel de navegação, escolha Maintenance Windows.

  3. Escolha o nome da janela de manutenção da qual deseja remover as tags e escolha a guia Tags.

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

  5. Escolha Salvar alterações.

Remover tags das janelas de manutenção (linha de comando)

  1. Usando sua ferramenta de linha de comando preferencial, execute o comando a seguir para listar as janelas de manutenção na sua conta.

    Linux & macOS
    aws ssm describe-maintenance-windows
    Windows
    aws ssm describe-maintenance-windows
    PowerShell
    Get-SSMMaintenanceWindows

    Observe o ID de uma janela de manutenção da qual você deseja remover tags.

  2. Execute o comando a seguir para remover tags de uma janela de manutenção. 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 "MaintenanceWindow" \
    --resource-id "window-id" \
    --tag-key "tag-key"
    Windows
    aws ssm remove-tags-from-resource ^
    --resource-type "MaintenanceWindow" ^
    --resource-id "window-id" ^
    --tag-key "tag-key"
    PowerShell
    Remove-SSMResourceTag `
    -ResourceType "MaintenanceWindow" `
    -ResourceId "window-id" `
    -TagKey "tag-key

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

  3. Execute o comando a seguir para verificar as tags da janela de manutenção.

    Linux & macOS
    aws ssm list-tags-for-resource \
    --resource-type "MaintenanceWindow" \
    --resource-id "window-id"
    Windows
    aws ssm list-tags-for-resource ^
    --resource-type "MaintenanceWindow" ^
    --resource-id "window-id"
    PowerShell
    Get-SSMResourceTag `
    -ResourceType "MaintenanceWindow" `
    -ResourceId "window-id"