Etiquetado de períodos de mantenimiento - AWS Systems Manager
Creación de períodos de mantenimiento con etiquetasAgregar etiquetas a períodos de mantenimiento existentesEliminación de etiquetas de los períodos de mantenimiento

Etiquetado de períodos de mantenimiento

En los temas de esta sección se describe cómo trabajar con etiquetas en períodos de mantenimiento.

Creación de períodos de mantenimiento con etiquetas

Puede agregar etiquetas a los períodos de mantenimiento en el momento de crearlas.

Para obtener información, consulte los siguientes temas:

Agregar etiquetas a períodos de mantenimiento existentes

Puede agregar etiquetas a los períodos de mantenimiento que posee mediante la consola o la línea de comandos de AWS Systems Manager.

Agregar etiquetas a un período de mantenimiento existente (consola)

  1. Abra la consola de AWS Systems Manager en https://console.aws.amazon.com/systems-manager/.

  2. En el panel de navegación, elija Maintenance Windows.

  3. Elija el nombre de un período de mantenimiento que ya ha creado y, a continuación, elija las pestañas Etiquetas.

  4. Elija Editar etiqueta y, a continuación, Agregar etiqueta.

  5. En Clave, escriba una clave para la etiqueta, como Environment.

  6. (Opcional) En Valor, escriba un valor para la etiqueta, por ejemplo, Test.

  7. Elija Guardar cambios.

Agregar etiquetas a un período de mantenimiento existente (AWS CLI)

  1. Con su herramienta de línea de comandos preferida, ejecute el siguiente comando para ver la lista de períodos de mantenimiento que puede etiquetar.

    aws ssm describe-maintenance-windows

    Anote el ID de un período de mantenimiento que desee etiquetar.

  2. Ejecute el siguiente comando para etiquetar un período de mantenimiento. Reemplace cada example resource placeholder con su propia información.

    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"

    Si todo es correcto, el comando no tiene salida alguna.

  3. Ejecute el siguiente comando para verificar las etiquetas del período de mantenimiento.

    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"

Etiquetado de un período de mantenimiento (AWS Tools for PowerShell).

  1. Ejecute el siguiente comando para enumerar los períodos de mantenimiento que puede etiquetar.

    Get-SSMMaintenanceWindow

  2. Ejecute los siguientes comandos para etiquetar un período de mantenimiento.

    $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 el ID del período de mantenimiento que desea etiquetar.

    key es el nombre de una clave personalizada que debe indicar. Por ejemplo, Entorno o Proyecto.

    tag-value es el contenido personalizado del valor que desee indicar para esa clave. Por ejemplo, Producción o T321.

  3. Ejecute el siguiente comando para verificar las etiquetas del período de mantenimiento.

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

Eliminación de etiquetas de los períodos de mantenimiento

Puede utilizar la consola o la línea de comandos de Systems Manager para eliminar etiquetas de los periodos de mantenimiento.

Eliminación de etiquetas de los períodos de mantenimiento (consola)

  1. Abra la consola de AWS Systems Manager en https://console.aws.amazon.com/systems-manager/.

  2. En el panel de navegación, elija Maintenance Windows.

  3. Elija el nombre del período de mantenimiento del que desea quitar las etiquetas y, a continuación, elija la pestaña Etiquetas.

  4. Elija Editar etiquetas y, a continuación, elija Eliminar etiqueta, junto al par de etiquetas que ya no necesite.

  5. Elija Guardar cambios.

Eliminación de etiquetas de los períodos de mantenimiento (línea de comandos)

  1. Con su herramienta de línea de comandos preferida, ejecute el siguiente comando para mostrar los períodos de mantenimiento de su cuenta.

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

    Anote el ID de un período de mantenimiento de la que desea eliminar etiquetas.

  2. Ejecute el siguiente comando para eliminar etiquetas de un período de mantenimiento. Reemplace cada example resource placeholder con su propia información.

    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

    Si todo es correcto, el comando no tiene salida alguna.

  3. Ejecute el siguiente comando para verificar las etiquetas del período de mantenimiento.

    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"