기존 복제 규칙에 대한 배치 복제 작업 생성 - Amazon Simple Storage Service

기존 복제 규칙에 대한 배치 복제 작업 생성

Amazon S3에서 라이브 복제는 복제 구성을 만들기 전에 소스 버킷에 이미 존재했던 객체를 복제하지 않습니다. 라이브 복제는 복제 구성이 생성된 후 버킷에 기록된 새 객체와 업데이트된 객체만 자동으로 복제합니다. 이미 존재하는 객체를 복제하려면 S3 배치 복제를 사용하여 요청 시 복제할 수 있습니다.

AWS SDK, AWS Command Line Interface(AWS CLI) 또는 Amazon S3 콘솔을 사용하여 기존 복제 구성에 대해 S3 배치 복제를 구성할 수 있습니다. 배치 복제에 대한 개요는 배치 복제를 사용한 기존 객체 복제 섹션을 참조하세요.

배치 복제 작업이 완료되면 완료 보고서를 수신합니다. 보고서를 사용하여 작업을 검사하는 방법에 대한 자세한 정보는 작업 상태 및 완료 보고서 추적 섹션을 참조하세요.

사전 조건

배치 복제 작업을 만들기 전에 Batch Operations AWS Identity and Access Management(IAM) 역할을 만들어 사용자를 대신해서 작업을 수행할 수 있는 Amazon S3 권한을 부여해야 합니다. 자세한 내용은 S3 배치 복제를 위한 IAM 역할 구성 단원을 참조하십시오.

  1. AWS Management Console에 로그인한 후 https://console.aws.amazon.com/s3/에서 Amazon S3 콘솔을 엽니다.

  2. 왼쪽 탐색 창에서 Batch Operations를 선택합니다.

  3. 작업 생성을 선택합니다.

  4. AWS 리전 섹션에 작업을 만들려는 리전이 표시되는지 확인합니다.

  5. 매니페스트 섹션에서 사용하려는 매니페스트 형식을 지정합니다. 매니페스트는 지정된 작업을 실행해야 하는 모든 객체의 목록입니다. 배치 작업 매니페스트에 대한 자세한 내용은 매니페스트 지정 섹션을 참조하세요.

    • 매니페스트를 준비한 경우 S3 인벤토리 보고서(manifest.json) 또는 CSV를 선택합니다. 매니페스트가 버전이 지정된 버킷에 있는 경우 매니페스트의 버전 ID를 지정할 수 있습니다. 버전 ID를 지정하지 않으면 Batch Operations에서는 매니페스트의 현재 버전을 사용합니다. 매니페스트 생성에 대한 자세한 내용은 매니페스트 지정 섹션을 참조하세요.

      참고

      매니페스트의 객체가 버전 지정된 버킷에 있는 경우 객체의 버전 ID를 지정해야 합니다. 자세한 내용은 매니페스트 지정 단원을 참조하십시오.

    • 복제 구성을 기반으로 매니페스트를 생성하려면 S3 복제 구성을 사용한 매니페스트 생성(Create manifest using S3 Replication Configuration)을 선택합니다. 그런 다음 복제 구성의 소스 버킷을 선택합니다.

  6. (선택 사항) S3 복제 구성을 사용하여 매니페스트 만들기를 선택한 경우 객체를 만든 날짜 및 복제 상태와 같은 추가 필터를 포함할 수 있습니다. 복제 상태별로 필터링하는 방법에 대한 예제는 배치복제 작업에 대한 매니페스트 지정 섹션을 참조하세요.

  7. (선택 사항) S3 복제 구성을 사용하여 매니페스트 만들기를 선택한 경우 생성된 매니페스트를 저장할 수 있습니다. 이 매니페스트를 저장하려면 Batch Operations 매니페스트 저장을 선택합니다. 그런 다음 매니페스트의 대상 버킷을 지정하고 매니페스트를 암호화할지 여부를 선택합니다.

    참고

    생성된 매니페스트는 소스 버킷과 동일한 AWS 리전에 저장되어야 합니다.

  8. Next(다음)를 선택합니다.

  9. 작업 페이지에서 복제를 선택한 후 다음을 선택합니다.

  10. (선택 사항) 설명을 입력합니다.

  11. 필요한 경우 작업의 우선 순위를 조정합니다. 숫자가 높을 수록 우선순위가 높아집니다. Amazon S3는 우선 순위가 낮은 작업에 앞서 우선 순위가 높은 작업을 실행하려고 시도합니다. 작업 우선 순위에 대한 자세한 내용은 작업 우선 순위 지정 섹션을 참조하세요.

  12. (선택 사항) 완료 보고서를 생성합니다. 이 보고서를 생성하려면 완료 보고서 생성을 선택합니다.

    완료 보고서를 생성하도록 선택한 경우 실패한 작업만(Failed tasks only) 또는 모든 작업(All tasks)을 선택하고 보고서의 대상 버킷을 제공해야 합니다.

  13. 권한 섹션에서 배치 복제에 필요한 권한이 있는 IAM 역할을 선택해야 합니다. 복제가 실패하는 가장 흔한 이유 중 하나는 제공된 IAM 역할의 사용 권한이 충분하지 않기 때문입니다. 이 역할을 생성하는 방법에 대한 상세 정보는 S3 배치 복제를 위한 IAM 역할 구성을(를) 참조하세요.

  14. (선택 사항) 배치 복제 작업에 작업 태그를 추가합니다.

  15. Next(다음)를 선택합니다.

  16. 작업 구성을 살펴본 후 작업 만들기를 선택합니다.

다음 예제 create-job 명령에서는 AWS 계정 111122223333에 대해 S3 생성 매니페스트를 사용하여 S3 배치 복제 작업을 생성합니다. 이 예제에서는 기존 객체와 이전에 복제하지 못한 객체를 복제합니다. 복제 상태별 필터링에 대한 자세한 내용은 배치복제 작업에 대한 매니페스트 지정 섹션을 참조하세요.

이 명령을 사용하려면 user input placeholders를 실제 정보로 대체합니다. role/batch-Replication-IAM-policy IAM 역할을 이전에 만든 IAM 역할로 대체합니다. 자세한 내용은 S3 배치 복제를 위한 IAM 역할 구성 단원을 참조하십시오.

aws s3control create-job --account-id 111122223333 \ 
--operation '{"S3ReplicateObject":{}}' \ 
--report '{"Bucket":"arn:aws:s3:::amzn-s3-demo-completion-report-bucket",\ 
"Prefix":"batch-replication-report", \ 
"Format":"Report_CSV_20180820","Enabled":true,"ReportScope":"AllTasks"}' \ 
--manifest-generator '{"S3JobManifestGenerator": {"ExpectedBucketOwner": "111122223333", \ 
"SourceBucket": "arn:aws:s3:::amzn-s3-demo-source-bucket", \ 
"EnableManifestOutput": false, "Filter": {"EligibleForReplication": true, \ 
"ObjectReplicationStatuses": ["NONE","FAILED"]}}}' \ 
--priority 1 \ 
--role-arn arn:aws:iam::111122223333:role/batch-Replication-IAM-policy \ 
--no-confirmation-required \ 
--region source-bucket-region
참고

복제 소스 버킷과 동일한 AWS 리전에서 작업을 시작해야 합니다.

배치복제 작업을 성공적으로 시작한 후에는 작업 ID를 응답으로 받게 됩니다. 다음 describe-job 명령을 사용하여 이 작업을 모니터링할 수 있습니다. 이 명령을 사용하려면 user input placeholders를 실제 정보로 대체합니다.

aws s3control describe-job --account-id 111122223333 --job-id job-id --region source-bucket-region

다음 예제에서는 AWS 계정 111122223333에 대해 사용자 정의 매니페스트를 사용하여 S3 배치 복제 작업을 생성합니다. 매니페스트의 객체가 버전 지정된 버킷에 있는 경우 객체의 버전 ID를 지정해야 합니다. 매니페스트에 지정된 버전 ID를 가진 객체만 복제됩니다. 매니페스트 생성에 대한 자세한 내용은 매니페스트 지정 섹션을 참조하세요.

이 명령을 사용하려면 user input placeholders를 실제 정보로 대체합니다. role/batch-Replication-IAM-policy IAM 역할을 이전에 만든 IAM 역할로 대체합니다. 자세한 내용은 S3 배치 복제를 위한 IAM 역할 구성 단원을 참조하십시오.

aws s3control create-job --account-id 111122223333 \ 
--operation '{"S3ReplicateObject":{}}' \
--report '{"Bucket":"arn:aws:s3:::amzn-s3-demo-completion-report-bucket",\
"Prefix":"batch-replication-report", \
"Format":"Report_CSV_20180820","Enabled":true,"ReportScope":"AllTasks"}' \
--manifest '{"Spec":{"Format":"S3BatchOperations_CSV_20180820",\
"Fields":["Bucket","Key","VersionId"]},\
"Location":{"ObjectArn":"arn:aws:s3:::amzn-s3-demo-manifest-bucket/manifest.csv",\
"ETag":"Manifest Etag"}}' \
--priority 1 \
--role-arn arn:aws:iam::111122223333:role/batch-Replication-IAM-policy \
--no-confirmation-required \
--region source-bucket-region
참고

복제 소스 버킷과 동일한 AWS 리전에서 작업을 시작해야 합니다.

배치복제 작업을 성공적으로 시작한 후에는 작업 ID를 응답으로 받게 됩니다. 다음 describe-job 명령을 사용하여 이 작업을 모니터링할 수 있습니다.

aws s3control describe-job --account-id 111122223333 --job-id job-id --region source-bucket-region