Batch Operations 문제 해결 - Amazon Simple Storage Service
NoSuchJobExceptionAccessDeniedExceptionSlowDownErrorInvalidManifestContent

Batch Operations 문제 해결

다음 주제에는 Amazon S3 Batch Operations 사용 중에 발생할 수 있는 문제를 해결하는 데 도움이 되는 일반적인 오류가 나열되어 있습니다.

S3 배치 복제와 관련된 문제를 해결하려면 배치 복제 오류 섹션을 참조하세요.

배치 작업 오류가 발생하는 두 가지 기본 유형의 실패가 있습니다.

  • API 실패 - 요청된 API(예: CreateJob)를 실행하지 못했습니다.

  • 작업 실패 - 초기 API 요청이 성공했지만 매니페스트 문제 또는 매니페스트에 지정된 객체에 대한 권한으로 인해 작업이 실패했습니다.

NoSuchJobException

유형: API 실패

이는 작업이 만료되었거나 CreateJob 요청에 사용된 ID가 DescribeJob 또는 UpdateJobStatus 요청에 사용된 ID와 같지 않은 경우에 발생할 수 있습니다.

작업은 터미널 상태(Complete, Cancelled 또는 Failed)에서 90일 후에 만료됩니다. 자세한 내용은 작업 상태 및 완료 보고서 추적 섹션을 참조하세요.

관련 오류 메시지

No such job

권장 조치

NoSuchJobException 문제 해결을 위해 다음 단계를 시도할 수 있습니다.

  1. 작업이 존재하고 계정에 있는지 확인합니다. 다음 AWS CLI 명령을 사용할 수 있습니다. aws s3control list-jobs --account-id 111122223333

  2. CreateJob 요청에서 수신된 ID가 DescribeJob 또는 UpdateJobStatus 요청에 사용된 ID와 동일한지 확인합니다.

AccessDeniedException

유형: API 실패

AccessDeniedException은 지원되지 않는 작업으로 인해 S3 Batch Operations 요청이 차단되거나 요청을 수행하는 IAM ID에 작업을 수행할 수 있는 충분한 권한이 없는 경우에 발생합니다.

관련 오류 메시지

Access Denied

권장 조치

AccessDeniedException 문제를 해결하려면 다음을 시도할 수 있습니다.

  1. S3 Batch Operations가 리전에서 작업 또는 기능을 지원하는지 확인합니다. 지원되는 작업 목록은 S3 배치 작업에서 지원하는 작업을(를) 참조하세요. 배치 작업은 모든 리전의 범용 버킷에 대해 지원되지만, 디렉터리 버킷에 대한 작업은 디렉터리 버킷의 리전 및 영역 엔드포인트에서만 사용할 수 있습니다.

  2. 요청을 하는 IAM ID에 배치 작업을 만들고 관리할 수 있는 권한이 있는지 확인합니다. 권한 목록은 배치 작업에 대한 권한 부여 섹션을 참조하세요.

SlowDownError

유형: API 실패

계정에서 S3 Batch Operations에 대한 요청 속도 제한을 초과한 경우 SlowDownError 예외가 발생합니다.

권장 조치

SlowDownError 예외를 해결하려면 다음을 시도할 수 있습니다.

  1. 요청 속도를 줄이고 다시 시도합니다. 자세한 내용은 AWS 권장 가이드의 백오프 패턴으로 재시도를 참조하세요.

InvalidManifestContent

유형: 작업 실패

매니페스트 파일 형식에 문제가 있거나 S3 Batch Operations이 객체를 처리하는 데 사용하는 콘텐츠에 문제가 있는 경우 InvalidManifestContent 예외가 발생합니다.

관련 오류 메시지

  • Required fields are missing in the schema: + missingFields

  • Invalid Manifest Content

  • The S3 Batch Operations job failed because it contains more keys than the maximum allowed in a single job. Please split the job into multiple smaller jobs or reach out to customer support for next steps.

권장 조치

InvalidManifestContent 문제 해결을 위해 다음 단계를 시도할 수 있습니다.

매니페스트 형식 문제의 경우:

  1. 매니페스트가 필수 형식 사양을 따르는지 확인합니다. 필요한 모든 열이 있어야 하며, 형식이 적절하고 매니페스트 전체에서 일관되어야 합니다. 예시는 매니페스트 지정 섹션을 참조하세요.

콘텐츠 문제의 경우:

  1. 객체 키의 특수 문자를 XML 엔터티 코드로 바꾸고 객체 키가 Amazon S3 이름 지정 규칙을 충족하는지 확인합니다. 자세한 내용은 Amazon S3 객체 이름 지정 섹션을 참조하세요.

  2. 모든 객체 키가 URL로 인코딩되어 있는지 확인합니다.

  3. 대규모 작업을 더 작은 작업으로 나눕니다. 각 작업 S3 배치 작업에서 지원하는 작업에 대해 지원되는 객체 수를 확인할 수 있습니다.