Systems Manager 유지 관리 기간에 자동화 작업을 등록할 때 파라미터를 추가하려면 어떻게 해야 합니까?

간략한 설명

유지 관리 기간 자동화 작업을 등록할 때는 작업이 실행될 때 해당 작업에 전달되는 입력 파라미터 값을 제공해야 합니다. 필수 입력 파라미터는 자동화 문서 내용에 정의된 파라미터와 동일합니다. 필수 입력 파라미터 필드에 의사 파라미터 값을 사용하여 유지 관리 기간이 대상으로 하는 리소스 ID를 동적으로 참조할 수 있습니다. **{{RESOURCE_ID}}**와 같은 의사 파라미터를 사용하면 각 리소스 ID를 개별적으로 입력할 필요가 없도록 여러 리소스를 대상으로 지정할 수 있습니다.

예를 들어 Amazon에서 제공한 AWS-StopEC2Instance 문서에서는 인스턴스 ID를 파라미터로 입력해야 합니다. 유지 관리 기간이 여러 인스턴스를 대상으로 하거나 인스턴스 ID를 모르는 경우 의사 파라미터를 사용하십시오.

참고: INSTANCE 대상 유형의 경우 {{TARGET_ID}} 및 {{RESOURCE_ID}} 의사 파라미터가 모두 인스턴스 ID만 제공합니다. 하지만 RESOURCE_GROUP 대상 유형의 경우에는 {{TARGET_ID}} 및 **{{RESOURCE_ID}}**가 서로 다른 형식의 ID를 반환합니다. 자세한 내용 및 사용 가능한 의사 파라미터 목록에 대해서는 유지 관리 기간 작업 등록 시 의사 파라미터 사용을 참조하십시오.

해결 방법

Systems Manager 콘솔 또는 AWS Command Line Interface(AWS CLI)를 사용하면 의사 파라미터를 사용하여 유지 관리 기간 자동화 작업을 등록할 수 있습니다.

Systems Manager 콘솔 사용

다음 단계를 완료하십시오.

1. Systems Manager 콘솔을 엽니다.
2. 탐색 창에서 유지 관리 기간을 선택한 다음, 원하는 유지 관리 기간을 선택합니다.
3. 작업 페이지에서 작업 등록을 선택하고 자동화 작업 등록을 선택합니다.
4. 자동화 작업 등록 페이지에서 다음 정보를 입력합니다.
   자동화 문서에서 작업을 실행할 문서를 선택합니다.
   대상에서 대상 정보를 지정합니다.
   입력 파라미터에 의사 파라미터 값을 입력합니다. 예를 들어 리소스 ID가 필요한 파라미터의 경우 TARGET_ID 또는 RESOURCE_ID를 입력합니다.
   속도 제어에서 속도 정보를 지정합니다.
   IAM 서비스 역할에서 AWS Identity and Access Management(IAM) 역할을 선택합니다.
5. 자동화 작업 등록을 선택합니다.

AWS CLI 사용

참고: AWS CLI 명령을 실행할 때 오류가 발생하면 AWS CLI의 오류 문제 해결을 참조하십시오. 또한 최신 AWS CLI 버전을 사용하고 있는지 확인하십시오.

register-task-with-maintenance-window 명령을 실행합니다.

다음 예제 명령은 {{RESOURCE_ID}} 파라미터를 포함한 자동화 작업을 등록합니다.

aws ssm register-task-with-maintenance-window --window-id mw-1234567890EXAMPLE --targets Key=WindowTargetIds,Values=6c226ea3-463a-4533-8a2d-EXAMPLE --task-arn AWS-StopEC2Instance --task-type AUTOMATION --name MyMaintenanceWindowTask --max-concurrency 10 --max-errors 5 --task-invocation-parameters={\"Automation\":{\"Parameters\":{\"InstanceId\":[\"{{RESOURCE_ID}}\"]}}} --service-role-arn YOUR_SERVICE_ROLE_ARN

유지 관리 기간 작업이 실행되면 각 대상의 리소스 ID가 시스템에 전달됩니다. 위 예제에서 InstanceId 파라미터는 대상 그룹의 각 대상에 대한 인스턴스 ID를 수신합니다.

관련 정보

지원되는 의사 파라미터

register-task-with-maintenance-windows 명령의 파라미터 옵션