S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive 스토리지 클래스에 있는 대량의 Amazon S3 객체를 복원하려면 어떻게 해야 합니까?

해결 방법

대량의 Amazon S3 Glacier 스토리지 클래스 객체를 복원하려면 Amazon S3 Batch Operations 또는 사용자 지정 AWS Command Line Interface(AWS CLI) 명령을 사용합니다.

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

S3 Batch Operations 사용

S3 Batch Operations 작업을 생성하여 모든 객체를 복원하십시오. 사용자 지정 객체 목록 또는 Amazon S3 Inventory 보고서에서 복원 작업을 실행할 수 있습니다.

전제 조건:

• 배치 작업에 대한 Amazon S3 요금을 검토합니다.
• 객체를 복원할 권한이 있는 AWS Identity and Access Management(IAM) 사용자 또는 역할이 있습니다. 또한 IAM 사용자 또는 역할에 Amazon S3 Batch Operations에 대한 신뢰 정책이 있어야 합니다.
• 복원하려는 객체의 매니페스트로 사용할 .csv 파일 또는 Amazon S3 Inventory 보고서가 있습니다. 매니페스트 파일을 S3 버킷에 저장합니다. 자세한 내용은 매니페스트 파일 생성을 참조하십시오.

Amazon S3 콘솔을 사용하여 배치 작업을 생성하고 복원을 시작하려면 다음 단계를 완료하십시오.

1. Amazon S3 콘솔을 엽니다.
2. 탐색 창에서 배치 작업을 선택합니다.
3. 작업 생성을 선택합니다.
4. 리전에서 작업을 생성하려는 AWS 리전을 선택합니다.
5. 매니페스트 선택에서 다음을 입력합니다.
   매니페스트 형식에 파일 형식으로 S3 인벤토리 보고서 또는 CSV를 선택합니다.
   매니페스트 객체 경로에 매니페이스 파일의 S3 경로(예: s3://awsexamplebucket/manifest.csv)를 입력합니다.
6. 다음을 선택합니다.
7. 작업 선택에서 다음을 입력합니다.
   작업에서 복원을 선택합니다.
   소스 복원에서 Glacier Flexible Retrieval 또는 Glacier Deep Archive를 선택합니다.
   복원된 사본을 사용할 수 있는 일수에 일수를 입력합니다.
   티어 복원에서 대량 검색 또는 표준 검색을 선택합니다.
   참고: S3 Batch Operations는 신속 검색 티어를 지원하지 않습니다.
8. 다음을 선택합니다.
9. 추가 옵션 구성에서 다음 항목을 입력합니다.
   (선택 사항) 설명에 설명을 입력합니다.
   우선순위에 작업의 우선순위에 해당하는 숫자를 입력합니다.
   완료 보고서 생성은 이 옵션을 선택한 상태로 유지합니다.
   완료 보고서 범위에서 실패한 작업만 또는 모든 작업을 선택합니다.
   완료 보고서 대상 경로에 보고서를 보낼 경로를 입력합니다.
   권한에서 기존 IAM 역할에서 선택을 선택한 다음, 필요한 권한이 있는 IAM 역할을 선택합니다.
10. 다음을 선택합니다.
11. 검토 페이지에서 작업의 세부 정보를 검토한 다음, 작업 생성을 선택합니다.
12. 작업을 선택하고 확인 및 실행을 선택합니다.
13. (선택 사항) 완료 보고서 생성을 선택한 경우, 작업이 완료된 후 보고서를 검토합니다. 보고서는 지정한 완료 보고서 대상 경로에서 찾을 수 있습니다.

각 작업 상태에 대한 설명은 작업 상태를 참조하십시오.

중요: 복원 작업에서는 객체 복원 요청만 시작합니다. 요청을 시작하면 S3 Batch Operations에서는 해당 객체에 대한 작업을 완료한 것으로 보고합니다. 배치 작업으로 객체가 복원된 후 Amazon S3는 작업을 업데이트하거나 사용자에게 알리지 않습니다. 하지만 Amazon S3에서 객체를 사용할 수 있게 되면 Amazon S3 이벤트 알림을 사용하여 알림을 받을 수 있습니다. 

실패한 작업에 대한 자세한 내용은 작업 실패 추적을 참조하십시오.

사용자 지정 AWS CLI 명령 사용

AWS CLI restore-object 명령을 실행하여 Amazon S3 Glacier 객체를 복원할 수 있습니다. 하지만 restore-object 명령은 한 번에 하나의 S3 Glacier 객체만 복원할 수 있으며 대량 복원 작업은 지원하지 않습니다.

S3 Glacier 스토리지 클래스에서 대량 데이터를 복원하려면 운영 체제(OS)에 맞게 다음 사용자 지정 명령을 사용하십시오.

참고: 프로덕션 환경에서 사용하기 전에 비프로덕션 환경에서 사용자 지정 스크립트를 테스트하는 것이 좋습니다. 객체가 너무 많으면 명령이 시간 초과될 수 있습니다. 객체 수를 줄이려면 명령에서 Prefix 파라미터를 사용하십시오.

Linux 또는 Unix 기반 시스템의 경우, 다음 list-objects 명령을 실행하여 버킷의 모든 S3 Glacier 객체를 복원합니다.

aws s3api list-objects --bucket bucket-name --prefix your-prefix --query 'Contents[?StorageClass==`GLACIER`][Key]' --output text | xargs -I {} sh -c "aws s3api restore-object --bucket bucket-name --key \"{}\" --restore-request Days=5,GlacierJobParameters={Tier=Standard} || true"

참고: bucket-name을 S3 버킷 이름으로, your-prefix를 S3 폴더 경로로, StorageClass 값을 GLACIER 또는 DEEP_ARCHIVE로 바꾸십시오.

Windows 기반 시스템의 경우 다음 단계를 완료하십시오.

1. 다음 list-objects 명령을 실행하여 버킷의 모든 S3 Glacier 객체를 나열합니다.

   aws s3api list-objects --bucket bucket-name --prefix your-prefix --query "Contents[?StorageClass==`GLACIER`][Key]" --output text > list.txt

   객체 목록은 list.txt 파일에 저장됩니다.

2. restore-object 명령을 실행하여 S3 Glacier 객체를 복원합니다.

   for /F "tokens=*" %i in (list.txt) do @aws s3api restore-object --bucket bucket-name --key "%i" --restore-request Days=5,GlacierJobParameters={Tier=Standard} || true"

참고: 위의 사용자 지정 AWS CLI 명령을 사용하면 목록 및 데이터 검색 요청에 대한 추가 요금이 부과됩니다. list-objects-v2 API는 페이지가 매겨진 작업이므로 여러 API 호출을 수행하면 전체 결과 데이터세트를 검색합니다.

관련 정보

아카이브 검색 옵션에 대한 이해

배치 작업을 사용하여 대량으로 객체 작업 수행

S3 Batch Operations 작업 관리