• AWS Systems Manager CloudWatch 대시보드는 2026년 4월 30일 이후에는 더 이상 사용할 수 없습니다. 고객은 Amazon CloudWatch 콘솔을 계속 사용하여 현재와 마찬가지로 Amazon CloudWatch 대시보드를 보고, 생성하고, 관리할 수 있습니다. 자세한 내용은 [Amazon CloudWatch 대시보드 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)를 참조하세요. # CLI로 `RegisterTargetWithMaintenanceWindow` 사용 다음 코드 예시는 `RegisterTargetWithMaintenanceWindow`의 사용 방법을 보여 줍니다. ------ #### [ CLI ] **AWS CLI** **예제 1: 유지 관리 기간에 단일 대상을 등록하는 방법** 다음 `register-target-with-maintenance-window` 예제에서는 유지 관리 기간에 인스턴스를 등록합니다. ``` aws ssm register-target-with-maintenance-window \ --window-id {{"mw-ab12cd34ef56gh78"}} \ --target {{"Key=InstanceIds,Values=i-0000293ffd8c57862"}} \ --owner-information {{"Single instance"}} \ --resource-type {{"INSTANCE"}} ``` 출력: ``` { "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2" } ``` **예제 2: 인스턴스 ID를 사용하여 유지 관리 기간에 여러 대상을 등록하는 방법** 다음 `register-target-with-maintenance-window` 예제에서는 인스턴스 ID를 지정하여 유지 관리 기간에 두 인스턴스를 등록합니다. ``` 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"}} ``` 출력: ``` { "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2" } ``` **예제 3: 리소스 태그를 사용하여 유지 관리 기간에 대상을 등록하는 방법** 다음 `register-target-with-maintenance-window` 예제에서는 인스턴스에 적용되는 리소스 태그를 지정하여 유지 관리 기간에 인스턴스를 등록합니다. ``` 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"}} ``` 출력: ``` { "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2" } ``` **예제 4: 태그 키 그룹을 사용하여 대상을 등록하는 방법** 다음 `register-target-with-maintenance-window` 예제에서는 키 값에 상관없이 모두 하나 이상의 태그가 지정된 인스턴스를 등록합니다. ``` aws ssm register-target-with-maintenance-window \ --window-id {{"mw-0c50858d01EXAMPLE"}} \ --resource-type {{"INSTANCE"}} \ --target {{"Key=tag-key,Values=Name,Instance-Type,CostCenter"}} ``` 출력: ``` { "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2" } ``` **예제 5: 리소스 그룹 이름을 사용하여 대상을 등록하는 방법** 다음 `register-target-with-maintenance-window` 예제에서는 포함된 리소스 유형에 상관없이 지정된 리소스 그룹을 등록합니다. ``` aws ssm register-target-with-maintenance-window \ --window-id {{"mw-0c50858d01EXAMPLE"}} \ --resource-type {{"RESOURCE_GROUP"}} \ --target {{"Key=resource-groups:Name,Values=MyResourceGroup"}} ``` 출력: ``` { "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2" } ``` 자세한 내용은 **AWS Systems Manager 사용 설명서의 [유지 관리 기간에 대상 인스턴스 등록(AWS CLI)](https://docs.aws.amazon.com/systems-manager/latest/userguide/mw-cli-tutorial-targets.html)을 참조하세요. + API 세부 정보는 **AWS CLI 명령 참조의 [RegisterTargetWithMaintenanceWindow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm/register-target-with-maintenance-window.html)를 참조하세요. ------ #### [ PowerShell ] **Tools for PowerShell V4** **예제 1: 이 예제에서는 유지 관리 기간에 한 인스턴스를 등록합니다.** ``` $option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862")} Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE" ``` **출력:** ``` d8e47760-23ed-46a5-9f28-927337725398 ``` **예제 2: 이 예제에서는 유지 관리 기간에 여러 인스턴스를 등록합니다.** ``` $option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862","i-0cb2b964d3e14fd9f")} Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE" ``` **출력:** ``` 6ab5c208-9fc4-4697-84b7-b02a6cc25f7d ``` **예제 3: 이 예제에서는 EC2 태그를 사용하여 유지 관리 기간에 인스턴스를 등록합니다.** ``` $option1 = @{Key="tag:Environment";Values=@("Production")} Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Production Web Servers" -ResourceType "INSTANCE" ``` **출력:** ``` 2994977e-aefb-4a71-beac-df620352f184 ``` + API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V4)*의 [RegisterTargetWithMaintenanceWindow](https://docs.aws.amazon.com/powershell/v4/reference)를 참조하세요. **Tools for PowerShell V5** **예제 1: 이 예제에서는 유지 관리 기간에 한 인스턴스를 등록합니다.** ``` $option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862")} Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE" ``` **출력:** ``` d8e47760-23ed-46a5-9f28-927337725398 ``` **예제 2: 이 예제에서는 유지 관리 기간에 여러 인스턴스를 등록합니다.** ``` $option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862","i-0cb2b964d3e14fd9f")} Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE" ``` **출력:** ``` 6ab5c208-9fc4-4697-84b7-b02a6cc25f7d ``` **예제 3: 이 예제에서는 EC2 태그를 사용하여 유지 관리 기간에 인스턴스를 등록합니다.** ``` $option1 = @{Key="tag:Environment";Values=@("Production")} Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Production Web Servers" -ResourceType "INSTANCE" ``` **출력:** ``` 2994977e-aefb-4a71-beac-df620352f184 ``` + API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [RegisterTargetWithMaintenanceWindow](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요. ------ AWS SDK 개발자 가이드 및 코드 예제의 전체 목록은 [AWS SDK와 함께 이 서비스 사용](sdk-general-information-section.md)을 참조하세요. 이 주제에는 시작하기에 대한 정보와 이전 SDK 버전에 대한 세부 정보도 포함되어 있습니다.