AWS Systems Manager Change Manager는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 AWS Systems Manager Change Manager 가용성 변경을 참조하세요.
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)을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 RegisterTargetWithMaintenanceWindow
를 참조하세요.
-
- 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를 참조하세요.
-
- 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를 참조하세요.
-
AWS SDK 개발자 가이드 및 코드 예시의 전체 목록은 AWS SDK와 함께 이 서비스 사용 섹션을 참조하세요. 이 주제에는 시작하기에 대한 정보와 이전 SDK 버전에 대한 세부 정보도 포함되어 있습니다.