AWS Systems Manager Change Manager ya no está abierto a nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte Cambio en la disponibilidad de Change Manager de AWS Systems Manager.
Utilizar RegisterTargetWithMaintenanceWindow con una CLI
Los siguientes ejemplos de código muestran cómo utilizar RegisterTargetWithMaintenanceWindow.
- CLI
-
- AWS CLI
-
Ejemplo 1: registro de un único destino con un periodo de mantenimiento
En el siguiente ejemplo de
register-target-with-maintenance-windowse registra una instancia con un periodo de mantenimiento.aws ssm register-target-with-maintenance-window \ --window-id"mw-ab12cd34ef56gh78"\ --target"Key=InstanceIds,Values=i-0000293ffd8c57862"\ --owner-information"Single instance"\ --resource-type"INSTANCE"Salida:
{ "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2" }Ejemplo 2: registro de varios destinos con un periodo de mantenimiento mediante los ID de instancia
En el siguiente ejemplo de
register-target-with-maintenance-windowse registran dos instancias con un periodo de mantenimiento especificando sus ID de instancia.aws ssm register-target-with-maintenance-window \ --window-id"mw-ab12cd34ef56gh78"\ --target"Key=InstanceIds,Values=i-0000293ffd8c57862,i-0cb2b964d3e14fd9f"\ --owner-information"Two instances in a list"\ --resource-type"INSTANCE"Salida:
{ "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2" }Ejemplo 3: registro de destinos con un periodo de mantenimiento mediante etiquetas de recursos
En el siguiente ejemplo de
register-target-with-maintenance-windowse registran las instancias con un periodo de mantenimiento especificando las etiquetas de recursos que se han aplicado a las instancias.aws ssm register-target-with-maintenance-window \ --window-id"mw-06cf17cbefcb4bf4f"\ --targets"Key=tag:Environment,Values=Prod""Key=Role,Values=Web"\ --owner-information"Production Web Servers"\ --resource-type"INSTANCE"Salida:
{ "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2" }Ejemplo 4: registro de destinos mediante un grupo de claves de etiquetas
En el siguiente ejemplo de
register-target-with-maintenance-windowse registran instancias que tienen una o más claves asignadas, independientemente de los valores de la clave.aws ssm register-target-with-maintenance-window \ --window-id"mw-0c50858d01EXAMPLE"\ --resource-type"INSTANCE"\ --target"Key=tag-key,Values=Name,Instance-Type,CostCenter"Salida:
{ "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2" }Ejemplo 5: registro de destinos con un nombre de grupo de recursos
En el siguiente ejemplo de
register-target-with-maintenance-windowse registra un grupo de recursos especificado, independientemente del tipo de recursos que contiene.aws ssm register-target-with-maintenance-window \ --window-id"mw-0c50858d01EXAMPLE"\ --resource-type"RESOURCE_GROUP"\ --target"Key=resource-groups:Name,Values=MyResourceGroup"Salida:
{ "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2" }Para obtener más información, consulte Registrar una instancia de destino con el periodo de mantenimiento (AWS CLI) en la Guía del usuario de AWS Systems Manager.
-
Para obtener información sobre la API, consulte RegisterTargetWithMaintenanceWindow
en la Referencia de comandos de la AWS CLI.
-
- PowerShell
-
- Herramientas para PowerShell V4
-
Ejemplo 1: en este ejemplo se registra una instancia con un periodo de mantenimiento.
$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862")} Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"Salida:
d8e47760-23ed-46a5-9f28-927337725398Ejemplo 2: en este ejemplo se registran varias instancias con un periodo de mantenimiento.
$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862","i-0cb2b964d3e14fd9f")} Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"Salida:
6ab5c208-9fc4-4697-84b7-b02a6cc25f7dEjemplo 3: en este ejemplo se registra una instancia con un periodo de mantenimiento mediante etiquetas de EC2.
$option1 = @{Key="tag:Environment";Values=@("Production")} Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Production Web Servers" -ResourceType "INSTANCE"Salida:
2994977e-aefb-4a71-beac-df620352f184-
Para obtener información sobre la API, consulte RegisterTargetWithMaintenanceWindow en la Referencia de Cmdlet de las Herramientas de AWS para PowerShell (V4).
-
- Herramientas para PowerShell V5
-
Ejemplo 1: en este ejemplo se registra una instancia con un periodo de mantenimiento.
$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862")} Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"Salida:
d8e47760-23ed-46a5-9f28-927337725398Ejemplo 2: en este ejemplo se registran varias instancias con un periodo de mantenimiento.
$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862","i-0cb2b964d3e14fd9f")} Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"Salida:
6ab5c208-9fc4-4697-84b7-b02a6cc25f7dEjemplo 3: en este ejemplo se registra una instancia con un periodo de mantenimiento mediante etiquetas de EC.
$option1 = @{Key="tag:Environment";Values=@("Production")} Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Production Web Servers" -ResourceType "INSTANCE"Salida:
2994977e-aefb-4a71-beac-df620352f184-
Para obtener información sobre la API, consulte RegisterTargetWithMaintenanceWindow en la Referencia de Cmdlet de las Herramientas de AWS para PowerShell (V5).
-
Para obtener una lista completa de las guías para desarrolladores de AWS SDK y ejemplos de código, consulte Cómo utilizar este servicio con un AWS SDK. En este tema también se incluye información sobre cómo comenzar a utilizar el SDK y detalles sobre sus versiones anteriores.
