AWS Systems Manager Change Manager não está mais aberto a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte mudança de disponibilidade do AWS Systems Manager Change Manager.
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-windowa 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"Resultado:
{ "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2" }Exemplo 2: registrar vários destinos em uma janela de manutenção usando IDs de instância
O exemplo de
register-target-with-maintenance-windowa seguir registra duas instâncias com uma janela de manutenção especificando seus IDs de instância.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"Resultado:
{ "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-windowa 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"Resultado:
{ "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-windowa 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"Resultado:
{ "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-windowa 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"Resultado:
{ "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 RegisterTargetWithMaintenanceWindow
na Referência de comandos da AWS CLI.
-
- 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-927337725398Exemplo 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-b02a6cc25f7dExemplo 3: esse exemplo registra uma instância com uma janela de manutenção usando tags do EC2.
$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 RegisterTargetWithMaintenanceWindow na Referência de cmdlets do Ferramentas da AWS para PowerShell (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-927337725398Exemplo 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-b02a6cc25f7dExemplo 3: esse exemplo registra uma instância com uma janela de manutenção usando tags do EC.
$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 RegisterTargetWithMaintenanceWindow na Referência de cmdlets do Ferramentas da AWS para PowerShell (V5).
-
Para ver uma lista completa dos Guias do desenvolvedor e exemplos de código do SDK da AWS, consulte Using this service with an AWS SDK. Este tópico também inclui informações sobre como começar e detalhes sobre versões anteriores do SDK.
