Systems Manager 유지 관리 기간 오류 문제를 해결하려면 어떻게 해야 하나요?

3분 분량

AWS Systems Manager의 기능인 유지 관리 기간을 사용하여 노드에서 작업을 예약하려고 하면 오류가 발생합니다.

간략한 설명

Maintenance Windows을 사용하여 인스턴스에서 잠재적으로 중단될 수 있는 작업을 수행하도록 일정을 설정합니다. 자세한 내용은 AWS Systems Manager Maintenance Windows을 참고하세요.

참고: Maintenance Windows 작업을 수행하려면 필요한 권한이 있는 AWS Identity and Access Management (IAM) 엔터티 역할(역할 또는 사용자)이 필요합니다. 자세한 내용은 유지 관리 윈도우 설정을 참고하세요.

해결 방법

Maintenance Windows 오류 문제를 해결하려면 오류 메시지에 따라 다음 작업을 완료하세요.

"Unable to assume the provided role"

Systems Manager Maintenance Windows 작업이 작업에 대해 설정된 IAM 서비스 역할을 맡을 수 없습니다. System Manager Maintenance Windows이 사용자를 대신하여 다른 AWS 서비스와 상호 작용할 수 있는 서비스 역할을 선택하세요. 역할에 대한 신뢰할 수 있는 관계 정책에서 ssm.amazonaws.com 서비스를 허용하는지 확인하세요. 이 주요 정책 요소는 시스템 관리자 작업이 지정된 IAM 역할을 맡는 데 필요합니다.

신뢰 관계 정책을 확인하고 업데이트하려면 다음 단계를 완료하세요.

IAM 콘솔을 엽니다.
탐색 창에서 역할을 선택합니다.
작업 정의에 포함시킨 역할을 선택한 다음 신뢰 관계 탭을 선택합니다.
신뢰 정책 편집을 선택합니다.

다음 신뢰 정책을 복사하여 편집 창에 붙여넣습니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "",
      "Effect": "Allow",
      "Principal": {
        "Service": "ssm.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

정책 업데이트를 선택합니다.

"The provided role does not contain the correct SSM permissions"

이 오류는 작업에 대한 Maintenance Window 서비스 역할을 지정했지만 작업이 성공적으로 실행되지 않을 때 발생합니다. 이 오류를 해결하려면 Maintenance Window 역할에 대한 IAM 정책에서 추가 권한을 제공하세요.

추가 권한을 제공하려면 다음 단계를 완료하세요.

IAM 콘솔을 엽니다.
탐색 창에서 역할을 선택합니다.
작업 정의에 포함시킨 역할을 선택한 다음 신뢰 관계 탭을 선택합니다.
역할에 필요한 권한을 추가합니다.

자세한 내용은 작업 간접 호출 상태가 작업 실패: "The provided role does not contain the correct SSM permissions."를 참고하세요.

"No Instances in Tag"

이 오류는 Maintenance Window 태그 키-값 쌍에 인스턴스 태그 키 값이 없거나 올바르지 않을 때 발생합니다.

인스턴스 태그 키 값을 수정하려면 다음 단계를 완료합니다.

시스템 관리자 콘솔을 엽니다.
탐색 창에서 Maintenance Window을 선택합니다.
Maintenance Windows에서 Window ID를 선택합니다.
대상 탭을 선택합니다.
Window 대상 ID에서 대상 ID를 선택한 다음 편집을 선택합니다.
대상에서 지정된 인스턴스 태그를 확인합니다.
Maintenance Window 태그 키-값 쌍이 요구 사항과 일치하면 이 키-값 쌍으로 인스턴스를 업데이트합니다.

"The specified parameters are incomplete or invalid"

이 오류는 Maintenance Window 자동화 작업에서 필수 매개변수 값이 누락되었거나 유효하지 않음을 의미합니다. 이 문제를 해결하려면 Systems Manager Maintenance Windows에 자동화 작업을 등록할 때 매개 변수를 추가하려면 어떻게 하나요?를 참고하세요.

"Failed"

실행 명령에서 속도 제어 제한을 초과하면 시간 초과 문제가 발생할 수 있습니다. 최대 오류율 제어 제한을 더 높은 수치로 늘리세요. 절대 오류 수 또는 목표 집합의 백분율을 지정할 수도 있습니다. 자세한 내용은 Systems Manager Run Command 시간 초과 문제 해결 방법을 참고하세요.