• O AWS Systems Manager CloudWatch Dashboard não estará mais disponível a partir de 30 de abril de 2026. Os clientes podem continuar usando o console do Amazon CloudWatch para visualizar, criar e gerenciar os painéis do Amazon CloudWatch exatamente como fazem hoje. Para obter mais informações, consulte a [documentação do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). # 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"}} ``` 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-window` a 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-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"}} ``` 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-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"}} ``` 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-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"}} ``` 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)](https://docs.aws.amazon.com/systems-manager/latest/userguide/mw-cli-tutorial-targets.html) no *Guia do usuário do AWS Systems Manager*. + Consulte detalhes da API em [RegisterTargetWithMaintenanceWindow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm/register-target-with-maintenance-window.html) 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-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 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 ``` + Consulte detalhes da API em [RegisterTargetWithMaintenanceWindow](https://docs.aws.amazon.com/powershell/v4/reference) 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-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 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](https://docs.aws.amazon.com/powershell/v5/reference) na *Referência de cmdlets do Ferramentas da AWS para PowerShell (V5)*. ------ Para ver uma lista completa dos guias de desenvolvedor e exemplos de código do SDK da AWS, consulte [Using this service with an AWS SDK](sdk-general-information-section.md). Este tópico também inclui informações sobre como começar e detalhes sobre versões anteriores do SDK.