Amazon S3 배치 복제 작업이 실패하는 이유는 무엇인가요?

3분 분량

Amazon Simple Storage Service(S3) 배치 복제 작업이 실패하는 이유를 알고 싶습니다.

간략한 설명

S3 배치 복제 작업이 실패하는 경우, 작업에 사용하는 AWS Identity and Access Management(IAM) 역할이 잘못 구성되었을 수 있습니다. 다음 작업을 완료하여 S3 배치 복제 작업 문제를 해결하세요.

(전제 조건) 복사 또는 복제할지 선택
IAM 역할 구성
작업 실패에 대한 기타 원인 문제 해결

해결 방법

전제 조건

배치 작업을 사용하는 경우 버킷의 객체를 복사하거나 복제하도록 선택할 수 있습니다. 배치 작업을 사용하기 전에 다음 정보를 검토하세요.

배치 작업의 경우 복사 용량 한도는 5GB입니다. 또한, 5GB 이상의 단일 객체를 복사할 수 없습니다. 복제에는 이러한 제한이 없습니다.
복제에는 생성일 및 버전 ID와 같은 복제된 객체의 메타데이터가 유지됩니다. 복제된 객체에는 객체 수준 액세스 제어 목록(ACL)도 유지됩니다. 복제를 사용하면 복제된 객체의 스토리지 클래스를 변경할 수 있습니다. 복사를 사용하면 이 정보를 보존하거나 스토리지 클래스를 변경할 수 없습니다.
복사를 사용하려면 원본 및 대상 버킷이 동일한 AWS 리전에 있어야 합니다.

자세한 내용은 S3 배치 복제 고려 사항을 참조하세요.

IAM 역할 구성

원본 버킷의 Amazon S3 복제 규칙은 S3 배치 복제 작업의 기반이 됩니다. S3 배치 복제 작업을 생성하려면 복제할 객체를 정의하고 보고서를 구성(선택 사항)합니다. S3 배치 복제 작업은 원본 S3 버킷에 구성된 복제 규칙에서 다른 모든 설정을 가져옵니다. 원본 버킷에 복제 규칙을 구성하지 않으면 복제를 위한 배치 작업이 실패합니다.

IAM 역할을 잘못 구성하면 S3 배치 복제 작업이 실패합니다. S3 배치 복제 작업은 다음과 같은 IAM 역할을 사용합니다.

배치 작업: “batchoperations.s3.amazonaws.com”이 이 역할을 맡으며 배치 작업을 생성할 때 구성됩니다. 이 역할을 사용하여 Amazon S3 매니페스트 및 구성을 관리합니다. 또한, 이 역할은 복제를 시작합니다. 자세한 내용은 배치 복제를 위한 IAM 정책 구성을 참조하세요.
복제 작업: “s3.amazonaws.com”이 이 역할을 맡으며 Amazon S3 복제 규칙을 생성할 때 구성됩니다. 이 역할을 사용하여 원본 버킷에서 대상 버킷으로 객체를 복제합니다. 자세한 내용은 버킷 간 복제를 설정해도 Amazon S3 객체가 복제되지 않는 이유는 무엇인가요?를 참조하세요.

IAM 역할을 구성한 후 복제 시나리오에 적합한 버킷의 복제 규칙을 구성하세요. 그런 다음 S3 배치 복제 작업을 구성합니다.

작업 실패에 대한 기타 원인 문제 해결

배치 역할 관련 문제

배치 역할에는 매니페스트 또는 구성에 대한 PUT 권한이 있어야 합니다. 또한, 매니페스트를 저장하는 버킷의 매니페스트에 대한 GET 권한이 있어야 합니다. 배치 작업 저장 매니페스트 옵션을 사용하는 경우 매니페스트 파일에 대한 GET 및 PUT 권한이 있어야 합니다. 배치 역할에 필요한 작업을 거부하지 않도록 매니페스트의 버킷 정책을 구성합니다. 자세한 내용은 배치 복제를 위한 IAM 정책 구성을 참조하세요.
교차 계정 버킷을 사용하는 경우, 버킷 정책에 배치 역할에 대한 권한이 있어야 합니다. 이러한 권한은 IAM 역할 정책에 추가됩니다.
버킷에 대해 AWS Key Management Service(AWS KMS) 또는 객체 수준 암호화를 사용하는 경우 AWS KMS 키에 배치 역할이 포함되어야 합니다. AWS KMS 키는 배치 역할이 버킷에서 데이터를 다운로드하고 업로드할 수 있도록 허용해야 합니다.
사용자 제공 매니페스트를 사용하는 경우 매니페스트에 IAM 역할에 대한 올바른 권한이 있어야 합니다. 교차 계정 버킷인 경우, 버킷 정책에 권한이 포함되어야 합니다. 버킷이 AWS KMS로 암호화된 경우 AWS KMS 키 정책에서 배치 역할에 매니페스트를 다운로드할 권한을 부여해야 합니다.

복제 역할 관련 문제

배치 작업이 오류율이 50% 를 초과하면서 실패하는 경우 복제 역할 구성의 문제가 원인일 수 있습니다. 배치 및 복제 작업에 동일한 역할을 사용하는 경우 Amazon S3 및 Amazon S3 배치 작업 서비스가 역할을 맡도록 허용하세요. 구성에서 두 권한 집합을 모두 허용하는지 확인하세요.

참고: Amazon S3용 매니페스트를 준비하는 데는 시간이 걸립니다. 배치 작업이 “준비” 단계에 있거나 몇 시간 동안 완료율이 동일한 경우 AWS Support에 문의하세요.