POST Object restore

설명

이 작업은 다음과 같은 유형의 요청을 수행합니다.

이 작업을 사용하려면 s3:RestoreObject 및 s3:GetObject 작업을 수행할 수 있는 권한이 있어야 합니다. 버킷 소유자는 기본적으로 이 권한을 보유하며 다른 사용자에게 이 권한을 부여할 수 있습니다. 권한에 대한 자세한 내용은 Amazon Simple Storage Service 사용 설명서의 버킷 하위 리소스 작업에 관련된 권한 및 Amazon S3 리소스에 대한 액세스 권한 관리를 참조하세요.

Select 요청으로 아카이브 쿼리

Select 요청 유형을 사용하여 아카이브된 객체에서 SQL 쿼리를 수행할 수 있습니다. Select 요청으로 쿼리되는 아카이브된 객체는 압축되지 않은, 쉼표로 분리된 값(CSV) 파일 형식이어야 합니다. 데이터를 더 핫한 Amazon S3 계층으로 복원할 필요 없이 아카이브된 데이터에 대해 쿼리 및 사용자 지정 분석을 실행할 수 있습니다. Select 요청에 대한 개요는 Amazon Simple Storage Service 사용 설명서의 아키이브된 객체 쿼리를 참조하세요.

Select 요청을 실행할 때 다음을 수행합니다.

Amazon Glacier Select 복원과 함께 SQL을 사용하는 방법에 대한 자세한 내용은 Amazon Simple Storage Service 사용 설명서의 Amazon S3 Select 및 Amazon Glacier Select용 SQL 참조를 참조하세요.

Select 요청을 실행할 때 다음 작업도 수행할 수 있습니다.

다음은 Select 기능에 대해 추가로 알아야 할 중요한 사항입니다.

아카이브 복원

GLACIER 및 DEEP_ARCHIVE 스토리지 클래스의 객체는 아카이브됩니다. 아카이브된 객체에 액세스하려면 먼저 복원 요청을 시작해야 합니다. 이 요청은 아카이브된 객체의 임시 복사본을 복원합니다. 복원 요청에서 복원하려는 객체 복사본의 복원 일수를 지정합니다. 지정된 기간이 경과하면 Amazon S3는 임시 복사본을 삭제하지만 객체는 해당 객체가 복원된 GLACIER 또는 DEEP_ARCHIVE 스토리지 클래스에 계속 아카이브됩니다.

특정 객체 버전을 복원하려면 버전 ID를 제공할 수 있습니다. 버전 ID를 제공하지 않으면 Amazon S3가 현재 버전을 복원합니다.

복원 작업을 완료하는 데 걸리는 시간은 객체가 복원되는 스토리지 클래스 및 지정된 데이터 액세스 계층에 따라 달라집니다.

아카이브된 객체를 복원할 때(또는 Select 요청을 사용할 때) 요청 본문의 Tier 요소에 다음 데이터 액세스 계층 옵션 중 하나를 지정할 수 있습니다.

Expedited 데이터 액세스를 위한 아카이브 검색 옵션 및 프로비저닝된 용량에 대한 자세한 내용은 Amazon Simple Storage Service 사용 설명서의 아카이브된 객체 복원을 참조하세요.

Amazon S3 복원 속도 업그레이드를 사용하여 복원이 진행되는 동안 복원 속도를 더 빠른 속도로 변경할 수 있습니다. 동일한 객체에 다른 복원 요청을 실행하면서 새 Tier 요청 요소를 설정하여 진행 중인 복원의 속도를 업그레이드합니다. 복원 티어를 업그레이드하라는 요청을 발행할 때는 진행 중인 복원이 사용하는 티어보다 빠른 티어를 선택해야 합니다. Days 요청 요소 등 다른 매개 변수는 변경하면 안 됩니다. 자세한 내용은 Amazon Simple Storage Service 사용 설명서의 진행 중인 복원 속도 업그레이드를 참조하세요.

객체 복원의 상태를 가져오려면 HEAD 요청을 전송할 수 있습니다. 작업은 응답에서 복원 상태에 대한 정보를 제공하는 x-amz-restore 헤더를 반환합니다. Amazon S3 이벤트 알림을 사용하여 복원이 시작되거나 완료되면 알림을 받을 수 있습니다. 자세한 내용은 Amazon Simple Storage Service 사용 설명서의 Amazon S3 이벤트 알림 구성을 참조하세요.

아카이브된 객체를 복원한 후 새 기간으로 요청을 다시 실행하여 복원 기간을 업데이트할 수 있습니다. Amazon S3는 현재 시점을 기준으로 복원 기간을 업데이트하고 요청에 대해서만 요금을 부과합니다. 데이터 전송 요금은 없습니다. Amazon S3가 객체에 대한 현재 복원 요청을 적극적으로 처리하는 경우에는 복원 기간을 업데이트할 수 없습니다.

버킷의 수명 주기 구성에 만료 작업이 포함된 규칙이 있는 경우 객체 만료는 복원 요청에서 지정한 수명을 재정의합니다. 예를 들어 10일간 객체 복사본을 복원했지만 객체가 3일 후에 만료되도록 예약된 경우 Amazon S3는 3일 후에 객체를 삭제합니다. 수명 주기 구성에 대한 자세한 내용은 Amazon Simple Storage Service 사용 설명서의 PutBucketLifecycleConfiguration 및 객체 수명 주기 관리를 참조하세요.

요청

구문

POST /ObjectName?restore&versionId=VersionID HTTP/1.1
Host: BucketName.s3.amazonaws.com
Date: date
Authorization: authorization string (see 요청 인증(AWS 서명 버전 4))
Content-MD5: MD5

 request body 
 

요청 파라미터

이 작업 구현에서는 요청 파라미터를 사용하지 않습니다.

요청 헤더

요청 요소

다음은 아카이브 복원을 위한 요청 본문의 XML 예제입니다.

<RestoreRequest>
   <Days>2</Days> 
   <GlacierJobParameters>
     <Tier>Bulk</Tier>
   </GlacierJobParameters> 
</RestoreRequest> 

다음 표에서는 요청 본문의 아카이브 복원을 위한 XML을 설명합니다.

다음 XML은 아카이브된 객체에 대한 Select 쿼리의 요청 본문입니다.

<RestoreRequest>
    <Type>SELECT</Type>
    <Tier>Expedited</Tier>
    <Description>Job description</Description>
    <SelectParameters>
          <Expression>Select * from Object</Expression>
          <ExpressionType>SQL</ExpressionType>
          <InputSerialization>
              <CSV>
                  <FileHeaderInfo>IGNORE</FileHeaderInfo>
                  <RecordDelimiter>\n</RecordDelimiter>
                  <FieldDelimiter>,</FieldDelimiter>
                  <QuoteCharacter>"</QuoteCharacter>
                  <QuoteEscapeCharacter>"</QuoteEscapeCharacter>
                  <Comments>#</Comments>
              </CSV>
           </InputSerialization>
         <OutputSerialization>
             <CSV>
                 <QuoteFields>ASNEEDED</QuoteFields>
                 <RecordDelimiter>\n</RecordDelimiter>
                 <FieldDelimiter>,</FieldDelimiter>
                 <QuoteCharacter>"</QuoteCharacter>
                 <QuoteEscapeCharacter>"</QuoteEscapeCharacter>
             </CSV>                                
         </OutputSerialization>
    </SelectParameters>
    <OutputLocation>
        <S3>
	     <BucketName>Name of bucket</BucketName>
            <Prefix>Key prefix</Prefix>
	      <CannedACL>Canned ACL string</CannedACL>
	      <AccessControlList>
		    <Grantee>
		        <Type>Grantee Type</Type>
			 <ID>Grantee identifier</ID>
			 <URI>Grantee URI</URI>
		       <Permission>Granted permission</Permission>
                    <DisplayNmae>Display Name</DisplayName>
                    <EmailAddress>email</EmailAddress>
		    </Grantee>
	      </AccessControlList>
	      <Encryption>
	            <EncryptionType>Encryption type</EncryptionType>
		     <KMSKeyId>KMS Key ID</KMSKeyId>
		     <KMSContext>Base64-encoded JSON<KMSContext>
            </Encryption>
	     <UserMetadata>
               <MetadataEntry>
                   <Name>Key</Name>
                   <Value>Value</Value>
               </MetadataEntry>
            </UserMetadata>
            <Tagging>
                <TagSet>
                    <Tag>
                        <Key>Tag name</Key>
                        <Value>Tag value</Value>
                    </Tag>
               </TagSet>
            </Tagging>
            <StorageClass>Storage class</StorageClass>
	 </S3>
    </OutputLocation>
</RestoreRequest>

다음 표에서는 요청 본문의 SELECT 복원 유형을 위한 XML을 설명합니다.

응답

작업이 성공하면 200 OK 또는 202 Accepted 상태 코드가 반환됩니다.

응답 헤더

이 작업의 구현에서는 대부분의 응답에 공통되는 응답 헤더만 사용합니다. 자세한 내용은 공통 응답 헤더를 참조하세요.

응답 요소

이 작업은 응답 요소를 반환하지 않습니다.

특수 오류

예제

신속 검색 옵션을 사용하여 2일간 객체 복원

다음 복원 요청은 신속 검색 옵션을 사용하여 Amazon Glacier에서 photo1.jpg 객체의 복사본을 2일간 복원합니다.

POST /photo1.jpg?restore HTTP/1.1
Host: examplebucket.s3.amazonaws.com
Date: Mon, 22 Oct 2012 01:49:52 GMT
Authorization: authorization string
Content-Length: content length

<RestoreRequest>
  <Days>2</Days>
  <GlacierJobParameters>
    <Tier>Expedited</Tier>
  </GlacierJobParameters>
</RestoreRequest>

examplebucket에 해당 객체의 복원된 복사본이 없는 경우 Amazon S3는 다음 202 Accepted 응답을 반환합니다.

HTTP/1.1 202 Accepted
x-amz-id-2: GFihv3y6+kE7KG11GEkQhU7/2/cHR3Yb2fCb2S04nxI423Dqwg2XiQ0B/UZlzYQvPiBlZNRcovw=
x-amz-request-id: 9F341CD3C4BA79E0
Date: Sat, 20 Oct 2012 23:54:05 GMT
Content-Length: 0
Server: AmazonS3

해당 객체의 복사본이 이미 복원된 경우 Amazon S3는 200 OK 응답을 반환하고 복원된 복사본의 만료 시간만 업데이트합니다.

SELECT 요청을 사용하여 아카이브 쿼리

다음은 예제 Select 복원 요청입니다.

POST /object-one.csv?restore HTTP/1.1
Host: examplebucket.s3.amazonaws.com
Date: Date: Sat, 20 Oct 2012 23:54:05 GMT
Authorization: authorization string
Content-Length: content length

<RestoreRequest xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Type>SELECT</Type>
  <Tier>Expedited</Tier>
  <Description>this is a description</Description>
  <SelectParameters>
    <InputSerialization>
      <CSV>
        <FileHeaderInfo>IGNORE</FileHeaderInfo>
        <Comments>#</Comments>
        <QuoteEscapeCharacter>"</QuoteEscapeCharacter>
        <RecordDelimiter>\n</RecordDelimiter>
        <FieldDelimiter>,</FieldDelimiter>
        <QuoteCharacter>"</QuoteCharacter>
      </CSV>
    </InputSerialization>
    <ExpressionType>SQL</ExpressionType>
    <Expression>select * from object</Expression>
    <OutputSerialization>
      <CSV>
        <QuoteFields>ALWAYS</QuoteFields>
        <QuoteEscapeCharacter>"</QuoteEscapeCharacter>
        <RecordDelimiter>\n</RecordDelimiter>
        <FieldDelimiter>\t</FieldDelimiter>
        <QuoteCharacter>\'</QuoteCharacter>
      </CSV>
    </OutputSerialization>
  </SelectParameters>
  <OutputLocation>
    <S3>
      <BucketName>example-output-bucket</BucketName>
      <Prefix>test-s3</Prefix>
      <AccessControlList>
        <Grant>
          <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="AmazonCustomerByEmail">
            <EmailAddress>jane-doe@example.com</EmailAddress>
          </Grantee>
          <Permission>FULL_CONTROL</Permission>
        </Grant>
      </AccessControlList>
      <UserMetadata>
        <MetadataEntry>
          <Name>test</Name>
          <Value>test-value</Value>
        </MetadataEntry>
        <MetadataEntry>
          <Name>other</Name>
          <Value>something else</Value>
        </MetadataEntry>
      </UserMetadata>
      <StorageClass>STANDARD</StorageClass>
    </S3>
  </OutputLocation>
</RestoreRequest>

Amazon S3는 다음 202 Accepted 응답을 반환합니다.

HTTP/1.1 202 Accepted
x-amz-id-2: GFihv3y6+kE7KG11GEkQhU7/2/cHR3Yb2fCb2S04nxI423Dqwg2XiQ0B/UZlzYQvPiBlZNRcovw=
x-amz-request-id: 9F341CD3C4BA79E0
x-amz-restore-output-path: js-test-s3/qE8nk5M0XIj-LuZE2HXNw6empQm3znLkHlMWInRYPS-Orl2W0uj6LyYm-neTvm1-btz3wbBxfMhPykd3jkl-lvZE7w42/
Date: Sat, 20 Oct 2012 23:54:05 GMT
Content-Length: 0
Server: AmazonS3

추가 정보