Usar RegisterTargetWithMaintenanceWindow com uma CLI

Os exemplos de código a seguir mostram como usar o RegisterTargetWithMaintenanceWindow.

CLI

AWS CLI

Exemplo 1: registrar um único destino com uma janela de manutenção

O exemplo de register-target-with-maintenance-window a seguir registra uma instância com uma janela de manutenção.

aws ssm register-target-with-maintenance-window \
    --window-id "mw-ab12cd34ef56gh78" \
    --target "Key=InstanceIds,Values=i-0000293ffd8c57862" \
    --owner-information "Single instance" \
    --resource-type "INSTANCE"

Saída:

{
    "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2"
}

Exemplo 2: Para registrar vários destinos com uma janela de manutenção usando a instância IDs

O register-target-with-maintenance-window exemplo a seguir registra duas instâncias com uma janela de manutenção especificando sua instância. IDs

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"

Saída:

{
    "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2"
}

Exemplo 3: registrar destinos com uma janela de manutenção usando tags de recursos

O exemplo de register-target-with-maintenance-window a seguir registra instâncias com uma janela de manutenção especificando tags de recursos que foram aplicadas às instâncias.

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"

Saída:

{
    "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2"
}

Exemplo 4: registrar destinos usando um grupo de chaves de tag

O exemplo de register-target-with-maintenance-window a seguir registra instâncias que têm uma ou mais chaves de tags atribuídas a elas, independentemente de seus valores de chave.

aws ssm register-target-with-maintenance-window \
    --window-id "mw-0c50858d01EXAMPLE" \
    --resource-type "INSTANCE" \
    --target "Key=tag-key,Values=Name,Instance-Type,CostCenter"

Saída:

{
    "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2"
}

Exemplo 5: registrar destinos usando um nome de grupo de recursos

O exemplo de register-target-with-maintenance-window a seguir registra um grupo de recursos especificado, independentemente do tipo de recurso que ele contém.

aws ssm register-target-with-maintenance-window \
    --window-id "mw-0c50858d01EXAMPLE" \
    --resource-type "RESOURCE_GROUP" \
    --target "Key=resource-groups:Name,Values=MyResourceGroup"

Saída:

{
    "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2"
}

Para obter mais informações, consulte Registrar uma instância de destino com a janela de manutenção (AWS CLI) no Guia do usuário do AWS Systems Manager.

• Para obter detalhes da API, consulte RegisterTargetWithMaintenanceWindowem Referência de AWS CLI Comandos.

PowerShell

Ferramentas para PowerShell V4

Exemplo 1: esse exemplo registra uma instância com uma janela de manutenção.

$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"

Saída:

d8e47760-23ed-46a5-9f28-927337725398

Exemplo 2: esse exemplo registra várias instâncias com uma janela de manutenção.

$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862","i-0cb2b964d3e14fd9f")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"

Saída:

6ab5c208-9fc4-4697-84b7-b02a6cc25f7d

Exemplo 3: Esse exemplo registra uma instância com uma janela de manutenção usando EC2 tags.

$option1 = @{Key="tag:Environment";Values=@("Production")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Production Web Servers" -ResourceType "INSTANCE"

Saída:

2994977e-aefb-4a71-beac-df620352f184

• Para obter detalhes da API, consulte RegisterTargetWithMaintenanceWindowem Referência de Ferramentas da AWS para PowerShell cmdlet (V4).

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo registra uma instância com uma janela de manutenção.

$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"

Saída:

d8e47760-23ed-46a5-9f28-927337725398

Exemplo 2: esse exemplo registra várias instâncias com uma janela de manutenção.

$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862","i-0cb2b964d3e14fd9f")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"

Saída:

6ab5c208-9fc4-4697-84b7-b02a6cc25f7d

Exemplo 3: Esse exemplo registra uma instância com uma janela de manutenção usando EC2 tags.

$option1 = @{Key="tag:Environment";Values=@("Production")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Production Web Servers" -ResourceType "INSTANCE"

Saída:

2994977e-aefb-4a71-beac-df620352f184

• Para obter detalhes da API, consulte RegisterTargetWithMaintenanceWindowem Referência de Ferramentas da AWS para PowerShell cmdlet (V5).