Amazon Simple Storage Service(S3) Glacier 또는 Amazon S3 Glacier Deep Archive 스토리지 클래스에 많은 수의 객체가 있습니다. 이러한 모든 객체에 대한 복원을 대규모 작업으로 시작하고 싶습니다.
해결 방법
대용량의 Amazon S3 Glacier 스토리지 클래스 객체를 복원하려면 다음 옵션 중 하나를 사용할 수 있습니다.
- Amazon S3 배치 작업
- AWS Command Line Interface(AWS CLI)를 사용하여 생성한 사용자 지정 스크립트
참고: AWS CLI 명령을 실행할 때 오류가 발생하면 최신 버전의 AWS CLI를 사용하고 있는지 확인하세요.
S3 배치 작업 사용
Amazon S3 배치 작업을 생성하여 모든 객체의 복원을 시작합니다. 사용자 지정 객체 목록 또는 Amazon S3 인벤토리 보고서에서 S3 객체 복원 시작 작업을 실행할 수 있습니다.
참고: 작업을 생성하기 전에 Amazon S3 배치 작업의 요금을 검토하세요.
S3 배치 작업 생성을 시작하기 전에 다음 요구 사항이 충족되는지 확인하세요.
- 복원을 시작할 권한이 있는 AWS Identity and Access Management(IAM) 사용자 또는 역할이 있습니다. 또한 IAM 사용자 또는 역할에는 Amazon S3 배치 작업에 대한 신뢰 정책이 있어야 합니다.
- 복원하려는 객체의 매니페스트 역할을 할 CSV 목록 또는 Amazon S3 인벤토리 보고서가 있습니다. 매니페스트 파일은 S3 버킷에 저장해야 합니다. 서버 측 암호화(고객 제공 키 또는 AWS Key Management Service 키)가 적용된 매니페스트는 지원되지 않습니다. 각 형식의 요구 사항에 대한 자세한 내용은 매니페스트 지정을 참조하세요.
Amazon S3 콘솔을 사용하여 복원을 시작하는 배치 작업을 생성하려면 다음을 수행합니다.
1. Amazon S3 콘솔을 엽니다.
2. 탐색 창에서 배치 작업을 선택합니다.
3. 작업 생성을 선택합니다.
4. 리전에는 작업을 생성하려는 AWS 리전을 선택합니다.
5. 매니페스트 선택에 다음을 입력합니다.
매니페스트 형식에 파일 형식으로 S3 인벤토리 보고서 또는 CSV를 선택합니다.
매니페스트 객체 경로에 매니페이스 파일에 대한 S3 경로(예: s3://awsexamplebucket/manifest.cs)를 입력합니다.
6. 다음을 선택합니다.
7. 작업 선택에 다음을 입력합니다.
작업에 복원을 선택합니다.
복원 소스에 Glacier 또는 Glacier Deep Archive를 선택합니다.
복원된 사본을 사용할 수 있는 일수에 사용 사례에 맞는 일수를 입력합니다.
복원 계층에 대량 검색 또는 표준 검색을 선택합니다. 각 계층에 대한 자세한 내용은 아카이브 검색 옵션을 참조하세요.
참고: S3 배치 작업은 빠른 검색 계층을 지원하지 않습니다.
8. 다음을 선택합니다.
9. 추가 옵션 구성에 다음 항목을 입력합니다.
설명에는 작업에 대한 설명을 입력할 수 있습니다. 또는 이 필드를 비워둘 수 있습니다.
우선순위에 작업의 우선순위를 나타내는 숫자를 입력합니다.
완료 보고서 생성은 이 옵션을 선택한 상태로 유지하도록 선택합니다.
완료 보고서 범위에는 사용 사례에 따라 실패한 작업만 또는 모든 작업을 선택합니다.
완료 보고서 대상 경로에는 보고서를 보낼 경로를 입력합니다.
권한에는 기존 IAM 역할에서 선택을 선택합니다. 그런 다음 복원을 시작할 권한이 있고 S3 일괄 작업에 대한 신뢰 정책이 있는 IAM 역할을 선택합니다.
10. 다음을 선택합니다.
11. 검토 페이지에서 작업의 세부 정보를 검토합니다. 그런 다음 작업 생성을 선택합니다.
12. 작업을 생성하면 작업의 상태가 신규에서준비 중으로 바뀝니다. 그런 다음 상태가 확인 대기 중으로 바뀝니다. 작업을 실행하려면 작업을 선택한 다음 확인 및 실행을 선택해야 합니다. 작업은 확인하기 전까지 실행되지 않습니다.
13. (선택 사항) 완료 보고서 생성을 선택한 경우, 작업이 완료된 후 보고서를 검토합니다. 보고서는 지정한 완료 보고서 대상 경로에서 찾을 수 있습니다.
각 작업 상태에 대한 설명은 작업 상태를 참조하세요.
실패한 작업에 대한 자세한 내용은 작업 실패 추적을 참조하십시오.
사용자 지정 AWS CLI 스크립트 사용
AWS CLI restore-object 명령으로 Amazon S3 Glacier 객체를 복원할 수 있습니다. 하지만 이 명령은 한 번에 하나의 S3 Glacier 객체만 복원할 수 있으며 대량 복원 작업은 지원하지 않습니다. 따라서 사용 가능한 검색 옵션을 사용하여 S3 Glacier 스토리지 클래스에서 대량 데이터를 복원하려면 다음 사용자 지정 솔루션을 사용하세요.
참고: 이러한 사용자 지정 스크립트는 운영 환경에서 사용하기 전에 테스트 환경이나 개발 환경에서 테스트해야 합니다. 사용자 지정 명령은 S3 Glacier 스토리지 클래스의 모든 객체를 하나씩 복원합니다. 객체가 너무 많으면 명령이 시간 초과될 수 있습니다. Prefix 파라미터를 지정하고 사용자 지정 명령을 실행하여 객체 수를 줄일 수 있습니다.
Linux 또는 UNIX 기반 시스템의 경우, 다음 명령을 실행하여 버킷의 모든 S3 Glacier 객체를 재귀적으로 복원합니다.
aws s3api list-objects --bucket <bucket-name> --prefix <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 버킷 이름으로 바꿉니다.
- **<prefix>**을(를) S3 폴더 경로로 바꿉니다.
Windows 기반 시스템의 경우 다음과 같이 하세요.
1. 다음 명령을 실행하여 버킷의 모든 S3 Glacier 객체를 나열합니다.
aws s3api list-objects --bucket <bucket-name> --prefix <prefix> --query "Contents[?StorageClass==`GLACIER`][Key]" --output text > list.txt
이 명령을 실행하면 객체 목록이 list.txt 파일에 저장됩니다.
2. 다음 명령을 실행하여 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 및 데이터 검색 요청에 대한 추가 요금이 부과됩니다. list-objects-v2는 페이지가 매겨진 작업이므로 전체 결과 데이터 세트를 검색하기 위해 여러 API 호출이 실행될 수 있습니다. 자세한 내용은 Amazon S3 가격 책정을 참조하세요.
관련 정보
S3 배치 작업 생성
Amazon S3 객체에 대규모 배치 작업 수행
S3 배치 작업 관리