아카이브된 객체 복원

Amazon S3 콘솔을 사용하여 객체 복원

S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive 스토리지 클래스나 S3 Intelligent-Tiering Archive Access 또는 Deep Archive Access 스토리지 계층에 아카이브된 객체를 복원하려면 다음 절차를 사용합니다.

S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive의 객체 복원

다음 예제에서는 restore-object 명령을 사용하여 amzn-s3-demo-bucket 버킷의 dir1/example.obj 객체를 25일 동안 복원합니다.

aws s3api restore-object --bucket amzn-s3-demo-bucket --key dir1/example.obj --restore-request '{"Days":25,"GlacierJobParameters":{"Tier":"Standard"}}'

예제에 사용된 JSON 구문으로 인해 Windows 클라이언트에서 오류가 발생하는 경우 복원 요청을 다음 구문으로 바꿉니다.

--restore-request Days=25,GlacierJobParameters={"Tier"="Standard"}

S3 Intelligent-Tiering Archive Access 및 Deep Archive Access의 객체 복원

다음 예제에서는 restore-object 명령을 사용하여 amzn-s3-demo-bucket 버킷의 dir1/example.obj 객체를 Frequent Access 계층으로 복원합니다.

aws s3api restore-object --bucket amzn-s3-demo-bucket --key dir1/example.obj --restore-request '{}'

복원 상태 모니터링

다음 head-object 명령을 실행하여 restore-object 요청 상태를 모니터링하려면 다음을 수행하세요.

aws s3api head-object --bucket amzn-s3-demo-bucket --key dir1/example.obj

자세한 정보는 AWS CLI 명령 참조의 restore-object 섹션을 참조하세요.

Amazon S3에서 제공한 API 작업으로 아카이브된 객체의 복원을 시작합니다. 자세한 내용은 Amazon Simple Storage Service API 참조에서 RestoreObject를 참조하십시오.

AWS SDK를 사용하여 S3 Glacier Flexier Retrieval 또는 S3 Glacier Deep Archive에 아카이브된 객체를 복원하는 방법의 예제는 Amazon S3 API 참조의 코드 예제를 참조하세요.

단일 요청으로 아카이브된 객체를 하나 이상 복원하려면 S3 배치 작업을 사용할 수 있습니다. 작업할 객체 목록을 S3 배치 작업에 제공합니다. S3 배치 작업은 지정된 작업을 수행하기 위해 각 API 작업을 호출합니다. 단일 배치 작업 건으로 엑사바이트 규모의 데이터가 포함된 수십억 개의 객체에서 지정된 작업을 수행할 수 있습니다.

배치 작업 건을 만들려면 복원할 개체만 포함된 매니페스트가 있어야 합니다. S3 인벤토리를 사용하여 매니페스트를 생성하거나 필요한 정보가 포함된 CSV 파일을 제공할 수 있습니다. 자세한 내용은 매니페스트 지정 단원을 참조하십시오.

S3 배치 작업 건을 생성하고 실행하기 전에 Amazon S3에 사용자 대신 S3 배치 작업을 수행할 권한을 부여해야 합니다. 필요한 권한에 대해서는 배치 작업에 대한 권한 부여 섹션을 참조하세요.

배치 작업에 대한 자세한 내용은 배치 작업을 통한 객체 복원 및 S3 배치 작업 건 생성 섹션을 참조하세요.

Amazon S3 이벤트 알림 기능과 함께 s3:ObjectRestore:Completed 작업을 사용하여 객체 복원 완료에 대해 알림을 받을 수 있습니다. 이벤트 알림 활성화에 대한 자세한 내용은 Amazon SQS, Amazon SNS 및 AWS Lambda를 사용한 알림 활성화를 참조하세요. 다양한 ObjectRestore 이벤트 유형에 대한 자세한 내용은 SQS, SNS 및 Lambda에 지원되는 이벤트 유형 단원을 참조하세요.

AWS CLI를 사용하여 객체의 복원 상태 및 만료 날짜를 확인합니다.

다음 예제에서는 head-object 명령을 사용하여 amzn-s3-demo-bucket 버킷의 dir1/example.obj 객체에 대한 메타데이터를 확인합니다. 복원 중인 객체에 대해 이 명령을 실행하면 Amazon S3에서 복원이 진행 중인지 여부와 만료 날짜(해당하는 경우)를 반환합니다.

aws s3api head-object --bucket amzn-s3-demo-bucket --key dir1/example.obj

예상 출력(복원 진행 중):

{
    "Restore": "ongoing-request=\"true\"",
    "LastModified": "2020-06-16T21:55:22+00:00",
    "ContentLength": 405,
    "ETag": "\"b662d79adeb7c8d787ea7eafb9ef6207\"",
    "VersionId": "wbYaE2vtOV0iIBXrOqGAJt3fP1cHB8Wi",
    "ContentType": "binary/octet-stream",
    "ServerSideEncryption": "AES256",
    "Metadata": {},
    "StorageClass": "GLACIER"
}

예상 출력(복원 완료):

{
    "Restore": "ongoing-request=\"false\", expiry-date=\"Wed, 12 Aug 2020 00:00:00 GMT\"",
    "LastModified": "2020-06-16T21:55:22+00:00",
    "ContentLength": 405,
    "ETag": "\"b662d79adeb7c8d787ea7eafb9ef6207\"",
    "VersionId": "wbYaE2vtOV0iIBXrOqGAJt3fP1cHB8Wi",
    "ContentType": "binary/octet-stream",
    "ServerSideEncryption": "AES256",
    "Metadata": {},
    "StorageClass": "GLACIER"
}

head-object에 대한 자세한 정보는 AWS CLI 명령 참조의 head-object 단원을 참조하세요.

Amazon S3는 객체 메타데이터를 검색할 수 있는 API 작업을 제공합니다. REST API를 사용하여 아카이브된 객체의 복원 상태 및 만료 날짜를 확인하려면 Amazon Simple Storage Service API 참조의 HeadObject 섹션을 참조하세요.