

# 아카이브된 객체 작업
<a name="archived-objects"></a>

자주 액세스하지 않는 객체의 스토리지 비용을 줄이려면 해당 객체를 *아카이브*합니다. 객체를 아카이브하면 저비용 스토리지로 이동되므로 실시간으로 액세스할 수 없습니다.

아카이브된 객체에 실시간으로 액세스할 수는 없지만 스토리지 클래스에 따라 몇 분 또는 몇 시간 내에 복원할 수 있습니다. Amazon S3 콘솔, S3 배치 작업, REST API, AWS SDK 및 AWS Command Line Interface(AWS CLI)를 사용하여 아카이브된 객체를 복원할 수 있습니다. 지침은 [아카이브된 객체 복원](restoring-objects.md) 섹션을 참조하세요.

다음 스토리지 클래스 또는 계층의 Amazon S3 객체는 아카이브되며 해당 객체에 실시간으로 액세스할 수 없습니다.
+ S3 Glacier Flexible Retrieval 스토리지 클래스
+ S3 Glacier Deep Archive 스토리지 클래스
+ S3 Intelligent-Tiering Archive Access 계층
+ S3 Intelligent-Tiering Deep Archive Access 계층

아카이브된 객체를 복원하려면 다음을 수행해야 합니다.
+ S3 Glacier Flexible Retrieval 및 S3 Glacier Deep Archive 스토리지 클래스에 있는 객체의 경우 복원 요청을 시작하고 객체의 임시 복사본을 사용할 수 있을 때까지 기다려야 합니다. 복원된 객체의 임시 사본이 생성된 경우 객체의 스토리지 클래스는 동일하게 유지됩니다. ([https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectHEAD.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectHEAD.html) 또는 [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html) API 작업 요청은 S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive를 스토리지 클래스로 요청합니다.) 
+ S3 Intelligent-Tiering Archive Access 및 S3 Intelligent-Tiering Deep Archive Access 계층에 있는 객체의 경우 복원 요청을 시작하고 객체가 Frequent Access 계층으로 이동할 때까지 기다려야 합니다.

모든 Amazon S3 스토리지 클래스 비교에 대한 자세한 내용은 [Amazon S3 스토리지 클래스 이해 및 관리](storage-class-intro.md) 섹션을 참조하세요. S3 Intelligent-Tiering에 대한 자세한 내용은 [S3 Intelligent-Tiering 작동 방식](intelligent-tiering-overview.md) 섹션을 참조하세요.

복원 작업을 완료하는 데 걸리는 시간은 사용하는 아카이브 스토리지 클래스 또는 스토리지 계층과 지정한 검색 옵션(긴급(S3 Glacier Flexible Retrieval 및 S3 Intelligent-Tiering Archive Access에만 사용 가능), 스탠다드 또는 대량)에 따라 달라집니다. 자세한 내용은 [아카이브 가져오기 옵션 이해](restoring-objects-retrieval-options.md) 섹션을 참조하세요.

복원이 완료되면 Amazon S3 이벤트 알림을 사용하여 알림을 받을 수 있습니다. 자세한 내용은 [Amazon S3 이벤트 알림](EventNotifications.md) 섹션을 참조하세요.

## Amazon Glacier에서 객체 복원
<a name="archived-objects-glacier"></a>

S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive를 사용하는 경우 Amazon S3는 지정된 기간 동안만 객체의 임시 사본을 복원합니다. 그런 다음 복원된 객체 복사본을 삭제합니다. 복원 요청을 다시 발행하여 복원된 복사본의 만료 기간을 수정할 수 있습니다. 이 경우 Amazon S3는 현재 시간을 기준으로 만료 기간을 업데이트합니다.

**참고**  
S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive에서 아카이브된 객체를 복원하면 아카이브된 객체와 임시로 복원한 사본 모두에 대해 요금이 청구됩니다. 요금에 대한 자세한 내용은 [Amazon S3 요금](https://aws.amazon.com/s3/pricing/)을 참조하십시오.

Amazon S3는 복원 요청에 지정된 일수와 요청한 복원이 완료된 시간을 더하여 복원된 객체 복사본의 만료 시간을 계산합니다. 그런 다음 Amazon S3는 협정 세계시(UTC) 자정에 그 다음 날로 결과 시간을 반올림합니다. 예를 들어 복원된 객체가 2012년 10월 15일 오전 10시 30분(UTC)에 생성되었으며 복원 기간이 3일로 지정되었다고 가정하겠습니다. 이 경우 복원된 복사본은 2012년 10월 19일 00:00(UTC)에 만료되며 이 시간에 Amazon S3가 객체 복사본을 삭제합니다.

## S3 Intelligent-Tiering에서 객체 복원
<a name="archived-objects-int"></a>

S3 Intelligent-Tiering Archive Access 계층 또는 S3 Intelligent-Tiering Deep Archive Access 계층에서 객체를 복원하는 경우 객체는 S3 Intelligent-Tiering Frequent Access 계층으로 이동합니다. 연속 30일이 지나는 동안 객체에 액세스하지 않으면 자동으로 Infrequent Access 계층으로 이동합니다. 액세스하지 않은 기간이 최소 연속 90일이 넘으면 객체가 자동으로 S3 Intelligent-Tiering Archive Access 계층으로 이동합니다. 최소 연속 180일 동안 객체에 액세스하지 않으면 객체가 Deep Archive Access 계층으로 이동합니다.

**참고**  
S3 Glacier Flexible Retrieval 및 S3 Glacier Deep Archive 스토리지 클래스와 달리 S3 Intelligent-Tiering 객체에 대한 복원 요청에는 `Days` 값을 사용할 수 없습니다.

## 복원 요청에 S3 배치 작업 사용
<a name="using-batch-ops-with-restore-requests"></a>

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

**Topics**
+ [Amazon Glacier에서 객체 복원](#archived-objects-glacier)
+ [S3 Intelligent-Tiering에서 객체 복원](#archived-objects-int)
+ [복원 요청에 S3 배치 작업 사용](#using-batch-ops-with-restore-requests)
+ [아카이브 가져오기 옵션 이해](restoring-objects-retrieval-options.md)
+ [아카이브된 객체 복원](restoring-objects.md)

# 아카이브 가져오기 옵션 이해
<a name="restoring-objects-retrieval-options"></a>

Amazon S3에는 S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval, S3 Glacier Deep Archive라는 세 가지 아카이브 스토리지 클래스가 있습니다. S3 Glacier Instant Retrieval 스토리지 클래스에 저장된 객체는 `GET`을 사용하여 즉시 액세스할 수 있지만, S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive 스토리지 클래스에 저장된 데이터에 액세스하려면 먼저 [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html) REST API를 사용하여 데이터를 검색해야 합니다. 수천만 개의 객체 또는 수백 테라바이트의 데이터로 구성된 데이터세트를 복원하는 데는 일반적인 복원 시간보다 오래 걸릴 수 있으며 특별한 고려 사항이 필요합니다. 자세한 내용은 [대용량 데이터세트 복원](#restoring-objects-large-datasets) 섹션을 참조하세요.

아카이브된 객체를 복원할 때 원하는 검색 속도에 따라 신속, 표준 및 대량의 세 가지 검색 액세스 옵션 중에서 선택할 수 있습니다.
+ **신속 검색** - S3 Glacier Flexible Retrieval 스토리지 클래스 또는 S3 Intelligent-Tiering Archive Access 계층에 저장된 데이터에 신속하게 액세스할 수 있습니다. 최대 수백 개의 객체에 대한 긴급 요청이 필요할 경우 이 옵션을 사용할 수 있습니다. 크기가 250메가바이트 미만인 객체는 일반적으로 1\$15분 이내에 사용 가능하며, 크기가 250메가바이트 이상인 객체는 일반적으로 초당 최대 300메가바이트의 검색 처리량으로 검색됩니다. 또한 신속 검색을 위한 프로비저닝된 용량을 구매할 수 있습니다. 프로비저닝된 용량을 통해 필요 시 신속 검색 용량을 사용할 수 있습니다. 자세한 내용은 [프로비저닝된 용량](#restoring-objects-expedited-capacity) 섹션을 참조하세요.
**참고**  
빠른 검색은 프리미엄 기능이며 빠른 요청 및 검색 요금이 부과됩니다. Amazon S3 요금에 관한 자세한 내용은 [Amazon S3 요금](https://aws.amazon.com/s3/pricing/)을 참조하세요.
+ **표준 검색** - 몇 시간 내에 데이터에 액세스할 수 있습니다. 요청 시 검색 옵션을 지정하지 않을 경우 표준이 기본 옵션이 됩니다. 표준 검색은 일반적으로 S3 Glacier Flexible Retrieval 스토리지 클래스 또는 S3 Intelligent-Tiering Archive Access 계층의 경우 3\$15시간 이내에 완료됩니다. S3 Glacier Deep Archive 스토리지 클래스 또는 S3 Intelligent-Tiering Deep Archive Access 계층의 경우 표준 검색은 일반적으로 12시간 이내에 완료됩니다. 표준 검색은 S3 Intelligent-Tiering 스토리지 클래스에 저장된 객체에 대해 무료입니다.
**참고**  
S3 Glacier Flexible Retrieval 스토리지 클래스 또는 S3 Intelligent-Tiering Archive Access 계층에 저장된 객체의 경우, S3 Batch Operations의 복원 작업을 사용하여 시작된 표준 검색은 일반적으로 몇 분 이내에 시작되고 하루 최대 1\$12페타바이트의 처리량으로 3\$15시간 이내에 완료됩니다.
S3 Glacier Deep Archive 스토리지 클래스 또는 S3 Intelligent-Tiering Deep Archive Access 계층에 저장된 객체의 경우, Batch Operations를 사용하여 시작된 표준 검색은 일반적으로 하루 최대 1\$12페타바이트의 처리량으로 9시간 이내에 완료됩니다.
+ **대량 검색** - S3 Glacier 스토리지 클래스에서 가장 저렴한 검색 옵션을 사용하여 데이터에 액세스합니다. 대량 검색을 통해 심지어 대용량 데이터를 저렴하게 검색할 수 있습니다. S3 Glacier Flexible Retrieval 스토리지 클래스 또는 S3 Intelligent-Tiering Archive Access 계층에 저장된 객체의 경우, 대량 검색은 일반적으로 5\$112시간 이내에 완료됩니다. S3 Glacier Deep Archive 스토리지 클래스 또는 S3 Intelligent-Tiering Deep Archive Access 계층에 저장된 객체의 경우, 이러한 검색은 일반적으로 48시간 이내에 완료됩니다. S3 Glacier Flexible Retrieval 또는 S3 Intelligent-Tiering 스토리지 클래스에 저장된 객체의 경우 대량 검색이 무료입니다.

다음 테이블에는 아카이브 검색 옵션이 요약되어 있습니다. 요금에 대한 자세한 내용은 [Amazon S3 요금](https://aws.amazon.com/s3/pricing/)을 참조하십시오.


| 스토리지 클래스 또는 계층 | 신속 | 스탠다드(배치 작업 사용) | 스탠다드(배치 작업 미사용) | 대량 | 
| --- | --- | --- | --- | --- | 
|  S3 Glacier Flexible Retrieval 또는 S3 Intelligent-Tiering Archive Access  |  1\$15분  |  수분\$15시간  |  3\$15시간  |  5\$112시간  | 
|  S3 Glacier Deep Archive 또는 S3 Intelligent-Tiering Deep Archive Access  |  사용할 수 없음  |  9\$112시간  |  12시간 이내  |  48시간 이내  | 

`Expedited`, `Standard` 또는 `Bulk` 검색을 실행하려면 [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html) REST API 작업 요청의 `Tier` 요청 요소를 원하는 옵션으로 설정하거나 AWS Command Line Interface(AWS CLI) 또는 AWS SDK에서 동등한 옵션으로 설정합니다. 프로비저닝된 용량을 구매하였다면, 사용자의 프로비저닝된 용량을 통해 모든 신속 검색이 자동으로 수행됩니다.

## 대용량 데이터세트 복원
<a name="restoring-objects-large-datasets"></a>

수천만 개의 객체 또는 수백 테라바이트의 데이터로 구성된 데이터세트를 복원하는 경우 검색 제한으로 인해 모든 검색 계층에서 일반적인 복원 시간보다 오래 걸릴 수 있습니다.

S3 Glacier Flexible Retrieval, S3 Glacier Deep Archive 또는 S3 Intelligent-Tiering 스토리지 클래스에 저장된 객체에 대해 복원 요청을 시작할 때 검색 요청 할당량이 AWS 계정에 적용됩니다. S3 Glacier는 초당 최대 1,000개의 트랜잭션 속도로 복원 요청을 지원합니다. 이 속도를 초과할 경우, 유효한 요청은 제한되거나 거부되며 Amazon S3에서 `ThrottlingException` 오류를 반환합니다. S3 Batch Operations를 사용하면 단일 요청으로 여러 객체를 검색할 수 있으므로 계정에서 사용 가능한 복원 요청 속도를 최대한 활용할 수 있습니다. 자세한 내용은 [Batch Operations를 사용하여 대량으로 객체 작업 수행](batch-ops.md) 섹션을 참조하세요.

복원 요청을 시작한 후 S3 Glacier는 고객 계정당 하루 최대 1\$12페타바이트의 처리량으로 대규모 데이터세트 복원을 지원합니다. 어떤 복구 옵션을 선택하든 5테라바이트보다 큰 객체는 복원하는 데 더 오랜 시간이 걸리며, 복구 처리량은 초당 최대 300메가바이트입니다. 예를 들어 50테라바이트 S3 Glacier Flexible Retrieval 객체는 완료하는 데 최대 48시간이 걸릴 수 있습니다. 복원 한도를 늘려야 하는 경우 AWS Support에 문의할 수 있습니다.

## 프로비저닝된 용량
<a name="restoring-objects-expedited-capacity"></a>

프로비저닝된 용량은 긴급 검색에 대한 검색 용량이 필요할 때 S3 Glacier Flexible Retrieval의 용량을 제공합니다. 각 용량 단위로 5분마다 긴급 검색을 최소 3회 수행할 수 있고, 초당 최대 300메가바이트의 검색 처리량이 제공됩니다.

프로비저닝된 용량이 없으면 신속 검색은 수요가 많은 기간에는 수락되지 않을 수도 있습니다. 더 많은 데이터에 예측 가능하고 빠르게 액세스하려면 [S3 Glacier Instant Retrieval](https://aws.amazon.com/s3/storage-classes/glacier/instant-retrieval/) 스토리지 클래스를 사용하는 것이 좋습니다.

프로비저닝된 용량 단위는 AWS 계정에 할당됩니다. 따라서 버킷 소유자가 아닌 긴급 데이터 검색의 요청자가 프로비저닝된 용량 단위를 구매해야 합니다.

Amazon S3 콘솔, Amazon Glacier 콘솔, [프로비저닝된 용량 구매](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-PurchaseProvisionedCapacity.html) REST API 작업, AWS SDK 또는 AWS CLI를 사용하면 프로비저닝된 용량을 구매할 수 있습니다. 프로비저닝된 용량의 요금에 대한 자세한 내용은 [Amazon S3 요금](https://aws.amazon.com/s3/pricing/)을 참조하세요.

# 아카이브된 객체 복원
<a name="restoring-objects"></a>

다음 스토리지 클래스 또는 계층의 Amazon S3 객체는 아카이브되며 해당 객체에 실시간으로 액세스할 수 없습니다.
+ S3 Glacier Flexible Retrieval 스토리지 클래스
+ S3 Glacier Deep Archive 스토리지 클래스
+ S3 Intelligent-Tiering Archive Access 계층
+ S3 Intelligent-Tiering Deep Archive Access 계층

S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive 스토리지 클래스에 저장된 Amazon S3 객체에는 즉시 액세스할 수 없습니다. 이 스토리지 클래스의 객체에 액세스하려면 지정된 기간(일) 동안 객체의 임시 사본을 S3 버킷에 복원해야 합니다. 객체의 영구 사본이 필요한 경우, 객체를 복원한 후 Amazon S3 버킷에 객체의 사본을 만드세요. 복원된 객체 복사는 Amazon S3 콘솔에서 지원되지 않습니다. 이러한 유형의 복사 작업에는 AWS Command Line Interface(AWS CLI), AWS SDK 또는 REST API를 사용하세요. 사본을 만들고 스토리지 클래스를 변경하지 않는 한 객체는 S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive 스토리지 클래스에 계속 저장됩니다. 이 스토리지 클래스의 사용에 대한 자세한 내용은 [거의 액세스하지 않는 객체를 위한 스토리지 클래스](storage-class-intro.md#sc-glacier) 섹션을 참조하세요.

S3 Intelligent-Tiering Archive Access 및 Deep Archive Access 계층의 객체에 액세스하려면 복원 요청을 시작하고 객체가 Frequent Access 계층으로 이동할 때까지 기다려야 합니다. Archive Access 계층 또는 Deep Archive Access 계층에서 객체를 복원하면 객체가 Frequent Access 계층으로 다시 전환됩니다. 이 스토리지 클래스의 사용에 대한 자세한 내용은 [변경되는 또는 알 수 없는 액세스 패턴으로 데이터를 자동으로 최적화하는 스토리지 클래스](storage-class-intro.md#sc-dynamic-data-access) 섹션을 참조하세요.

아카이브된 객체에 대한 일반적인 정보는 [아카이브된 객체 작업](archived-objects.md) 섹션을 참조하세요.

**참고**  
S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive 스토리지 클래스에서 아카이브된 객체를 복원하는 경우, 아카이브된 객체와 임시로 복원한 사본 모두에 대해 요금이 청구됩니다.
S3 Intelligent-Tiering에서 객체를 복원하는 경우, 표준 또는 대량 검색에는 검색 요금이 부과되지 않습니다.
이미 복원된 아카이브 객체에 대해 요청된 후속 복원은 `GET` 요청으로 청구됩니다. 요금에 대한 자세한 내용은 [Amazon S3 요금](https://aws.amazon.com/s3/pricing/)을 참조하십시오.

## 아카이브된 객체 복원
<a name="restore-archived-objects"></a>

Amazon S3 콘솔, Amazon S3 REST API, AWS SDK, AWS Command Line Interface(AWS CLI) 또는 S3 배치 작업을 사용하여 아카이브된 객체를 복원할 수 있습니다.

### S3 콘솔 사용
<a name="restoring-objects-console"></a>

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

**아카이브된 객체 복원**

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

1. 왼쪽 탐색 창에서 **범용 버킷**을 선택합니다.

1. 버킷 목록에서 복원할 객체가 들어 있는 버킷 이름을 선택합니다.

1. [**객체(Objects)**] 목록에서 객체 또는 복원할 객체를 선택하고 [**작업(Actions)**]을 선택한 다음 [**복원 시작(Initiate restore)**]을 선택합니다.

1. S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive에서 복원하는 경우 **복원된 사본을 사용할 수 있는 기간(일)** 상자에 아카이브된 데이터에 액세스할 수 있는 기간(일)을 입력합니다.

1. **검색 티어**에서 다음 중 하나를 수행합니다.
   + **대량 검색** 또는 **표준 검색**을 선택하고 **복원 시작**을 선택합니다.
   + **긴급 검색(Expedited retrieval)**을 선택합니다(S3 Glacier Flexible Retrieval 또는 S3 Intelligent-Tiering Archive Access에만 사용 가능). S3 Glacier Flexible Retrieval에서 객체를 복원하는 경우 긴급 검색을 위해 프로비저닝된 용량을 구매할지 여부를 선택할 수 있습니다. 프로비저닝된 용량을 구매하려는 경우 다음 단계로 진행합니다. 그렇지 않은 경우 **복원 시작**을 선택합니다.
**참고**  
S3 Intelligent-Tiering Archive Access 및 Deep Archive Access 계층의 객체는 Frequent Access 계층으로 자동으로 복원됩니다.

1. (선택 사항) S3 Glacier Flexible Retrieval에서 객체를 복원하며 **긴급 검색**을 선택한 경우 프로비저닝된 용량을 구매할지 여부를 선택할 수 있습니다. 프로비저닝된 용량은 S3 Glacier Flexible Retrieval의 객체에만 사용할 수 있습니다. 프로비저닝된 용량이 있는 경우, **복원 시작**을 선택하여 프로비저닝된 검색을 시작합니다.

   프로비저닝된 용량이 있으면 모든 긴급 검색이 프로비저닝된 용량으로 처리됩니다. 자세한 내용은 [프로비저닝된 용량](restoring-objects-retrieval-options.md#restoring-objects-expedited-capacity) 섹션을 참조하세요.
   + 프로비저닝된 용량이 없고 구매할 계획도 없는 경우, **복원 시작**을 선택합니다.
   + 프로비저닝된 용량이 없지만 프로비저닝된 용량 단위(PCU)를 구매하려는 경우 **PCU 구매**를 선택합니다. **PCU 구매** 대화 상자에서 구매하려는 PCU 수를 선택하고 구매를 확인한 다음 **PCU 구매**를 선택합니다. **구매 성공** 메시지가 나타나면 **복원 시작**을 선택하여 프로비저닝된 검색을 시작합니다.

### AWS CLI 사용
<a name="restoring-objects-cli"></a>

**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 '{}'
```

**참고**  
S3 Glacier Flexible Retrieval 및 S3 Glacier Deep Archive 스토리지 클래스와 달리 S3 Intelligent-Tiering 객체에 대한 복원 요청에는 `Days` 값을 사용할 수 없습니다.

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

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

자세한 내용은 *AWS CLI 명령 참조*의 [https://docs.aws.amazon.com//cli/latest/reference/s3api/restore-object.html](https://docs.aws.amazon.com//cli/latest/reference/s3api/restore-object.html) 섹션을 참조하십시오.

### REST API 사용
<a name="restoring-objects-rest"></a>

Amazon S3에서 제공한 API 작업으로 아카이브된 객체의 복원을 시작합니다. 자세한 내용은 *Amazon Simple Storage Service API 참조*에서 [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html)를 참조하세요.

### AWS SDK 사용
<a name="restoring-objects-sdks"></a>

AWS SDK를 사용하여 S3 Glacier Flexier Retrieval 또는 S3 Glacier Deep Archive에 아카이브된 객체를 복원하는 방법의 예제는 **Amazon S3 API 참조의 [코드 예제](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_RestoreObject_section.html)를 참조하세요.

### S3 배치 작업 사용
<a name="restoring-int-tier-archive-objects-batch-ops"></a>

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

배치 작업 건을 만들려면 복원할 개체만 포함된 매니페스트가 있어야 합니다. S3 인벤토리를 사용하여 매니페스트를 생성하거나 필요한 정보가 포함된 CSV 파일을 제공할 수 있습니다. 자세한 내용은 [매니페스트 지정](batch-ops-create-job.md#specify-batchjob-manifest) 섹션을 참조하세요.

S3 배치 작업 건을 생성하고 실행하기 전에 Amazon S3에 사용자 대신 S3 배치 작업을 수행할 권한을 부여해야 합니다. 필요한 권한에 대해서는 [배치 작업에 대한 권한 부여](batch-ops-iam-role-policies.md) 섹션을 참조하세요.

**참고**  
배치 작업 건은 S3 Glacier Flexible Retrieval 및 S3 Glacier Deep Archive 스토리지 클래스 객체 *또는* S3 Intelligent-Tiering Archive Access 및 Deep Archive Access 스토리지 계층 객체에서 작동할 수 있습니다. 배치 작업은 동일한 작업 건에 있는 두 가지 유형의 아카이브된 객체 모두에서 작동할 수 없습니다. 두 유형의 객체를 복원하려면 별도의 배치 작업을 생성*해야* 합니다.  
아카이브 객체 복원에 배치 작업을 사용하는 것에 대한 자세한 내용은 [배치 작업을 통한 객체 복원](batch-ops-initiate-restore-object.md) 섹션을 참조하세요.

**S3 객체 복원 시작 배치 작업을 생성하려면**

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

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

1. **작업 생성**을 선택합니다.

1. **AWS 리전**은 작업을 생성하려는 리전을 선택합니다.

1. **매니페스트 형식**에서 사용할 매니페스트의 형식을 선택합니다.
   + **S3 인벤토리 보고서**를 선택하는 경우 Amazon S3가 CSV 형식 인벤토리 보고서의 일부로 생성한 `manifest.json` 객체의 경로를 입력합니다. 최신 버전이 아닌 매니페스트 버전을 사용하려는 경우 `manifest.json` 객체의 버전 ID를 입력합니다.
   + **CSV**를 선택하는 경우 CSV 형식 매니페스트 객체의 경로를 입력합니다. 매니페스트 객체는 콘솔에 설명된 형식을 따라야 합니다. 최신 버전이 아닌 버전을 사용하려는 경우 선택적으로 매니페스트 객체의 버전 ID를 포함할 수 있습니다.

1. **다음**을 선택합니다.

1. **작업** 섹션에서 **복원**을 선택합니다.

1. **복원** 섹션에서 **복원 소스**로 **Glacier Flexible Retrieval 또는 Glacier Deep Archive** 또는 **Intelligent-Tiering Archive Access 계층 또는 Deep Archive Access 계층**을 선택합니다.

   **Glacier Flexible Retrieval 또는 Glacier Deep Archive**를 선택한 경우 **복원된 사본을 사용할 수 있는 기간(일)**에 숫자를 입력합니다.

   **검색 티어**에서 사용할 계층을 선택합니다.

1. **다음**을 선택합니다.

1. 

   **추가 옵션 구성** 페이지에서 다음 섹션을 작성합니다.
   + **추가 옵션** 섹션에서 작업에 대한 설명을 제공하고 작업의 우선 순위 번호를 지정합니다. 숫자가 높을수록 우선 순위가 높습니다. 자세한 내용은 [작업 우선 순위 지정](batch-ops-job-priority.md) 섹션을 참조하세요.
   + **완료 보고서** 섹션에서 배치 작업으로 완료 보고서를 생성할지 여부를 선택합니다. 완료 보고서에 대한 자세한 내용은 [완료 보고서](batch-ops-job-status.md#batch-ops-completion-report) 섹션을 참조하세요.
   + **권한** 섹션에서 Amazon S3에 사용자 대신 배치 작업을 수행할 권한을 부여해야 합니다. 필요한 권한에 대해서는 [배치 작업에 대한 권한 부여](batch-ops-iam-role-policies.md) 섹션을 참조하세요.
   + (선택 사항) **작업 태그** 섹션에서 키-값 페어로 태그를 추가합니다. 자세한 내용은 [태그를 사용하여 액세스 제어 및 작업 레이블 지정](batch-ops-job-tags.md) 섹션을 참조하세요.

   마쳤으면 **다음**을 선택합니다.

1. **복습** 페이지에서 설정을 확인합니다. 설정을 변경하려면 **이전**을 선택합니다 또는 **작업 생성**을 선택합니다.

배치 작업에 대한 자세한 내용은 [배치 작업을 통한 객체 복원](batch-ops-initiate-restore-object.md) 및 [S3 배치 작업 건 생성](batch-ops-create-job.md) 섹션을 참조하세요.

## 복원 상태 및 만료 날짜 확인
<a name="restore-archived-objects-status"></a>

Amazon S3 콘솔, Amazon S3 이벤트 알림, AWS CLI 또는 Amazon S3 REST API를 사용하여 복원 요청 상태 또는 만료 날짜를 확인할 수 있습니다.

**참고**  
S3 Glacier Flexible Retrieval 및 S3 Glacier Deep Archive 스토리지 클래스에서 복원된 객체는 지정된 일수 동안만 저장됩니다. 아래 절차에 따라 이러한 사본의 만료일이 반환됩니다.  
S3 Intelligent-Tiering Archive Access 및 Deep Archive Access 스토리지 계층에서 복원된 객체에는 만료 날짜가 없으며 대신 Frequent Access 계층으로 다시 이동됩니다.

### S3 콘솔 사용
<a name="restore-archived-objects-status-console"></a>

**Amazon S3 콘솔에서 객체의 복원 상태 및 만료 날짜를 확인하려면**

1. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **범용 버킷**을 선택합니다.

1. 버킷 목록에서 복원할 객체가 들어 있는 버킷 이름을 선택합니다.

1. **객체**목록에서 복원할 개체를 선택합니다. 객체 세부 정보 페이지가 나타납니다.
   + 복원이 완료되지 않은 경우 페이지 상단에 **복원 진행 중**이라는 섹션이 표시됩니다.
   + 복원이 완료된 경우 페이지 상단에 **복원 완료**라는 섹션이 표시됩니다. S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive에서 복원하는 경우 이 섹션에는 **복원 만료 날짜**도 표시됩니다. 이 날짜는 Amazon S3가 아카이브된 객체의 복원된 사본을 제거하는 날짜입니다.

### Amazon S3 이벤트 알림 사용
<a name="restore-archived-objects-status-event-notifications"></a>

Amazon S3 이벤트 알림 기능과 함께 `s3:ObjectRestore:Completed` 작업을 사용하여 객체 복원 완료에 대해 알림을 받을 수 있습니다. 이벤트 알림 활성화에 대한 자세한 내용은 [Amazon SQS, Amazon SNS 및 AWS Lambda를 사용한 알림 활성화](how-to-enable-disable-notification-intro.md)를 참조하세요. 다양한 `ObjectRestore` 이벤트 유형에 대한 자세한 내용은 [SQS, SNS 및 Lambda에 지원되는 이벤트 유형](notification-how-to-event-types-and-destinations.md#supported-notification-event-types) 단원을 참조하세요.

### AWS CLI 사용
<a name="restore-archived-objects-status-cli"></a>

**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 명령 참조의 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/head-object.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/head-object.html) 단원을 참조하세요.

### REST API 사용
<a name="restore-archived-objects-status-api"></a>

Amazon S3는 객체 메타데이터를 검색할 수 있는 API 작업을 제공합니다. REST API를 사용하여 아카이브된 객체의 복원 상태 및 만료 날짜를 확인하려면 *Amazon Simple Storage Service API 참조*의 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html) 섹션을 참조하세요.

## 진행 중인 복원의 속도 업그레이드
<a name="restore-archived-objects-upgrade"></a>

복원 진행 중에 복원 속도를 업그레이드할 수 있습니다.

**진행 중인 복원을 더 빠른 티어로 업그레이드**

1. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 Amazon S3 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **버킷**을 선택합니다.

1. **버킷(Buckets)** 목록에서 복원할 객체가 들어 있는 버킷 이름을 선택합니다.

1. **객체**목록에서 복원할 개체를 선택합니다. 객체 세부 정보 페이지가 나타납니다. 객체의 세부 정보 페이지에서 **검색 계층 업그레이드**를 선택합니다. 객체의 복원 상태 점검에 관한 내용은 [복원 상태 및 만료 날짜 확인](#restore-archived-objects-status) 섹션을 참조하세요.

1. 업그레이드할 계층을 선택한 후 **복원 시작**을 선택합니다.