本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

POST 物件還原

說明

此操作會執行下列類型的請求：

若要使用此操作，您必須具有執行 s3:RestoreObject和 s3:GetObject動作的許可。根據預設，儲存貯體擁有者具有此許可，並且可以將此許可授予其他人。如需許可的詳細資訊，請參閱《Amazon S3與儲存貯體子資源操作和管理 Amazon S3 資源存取許可相關的許可。

使用選取請求查詢封存

您可以使用選取類型的請求，對封存的物件執行 SQL 查詢。選取請求查詢的封存物件必須格式化為未壓縮的逗號分隔值 (CSV) 檔案。您可以對封存的資料執行查詢和自訂分析，而不必將資料還原至較熱的 Amazon S3 層。如需選取請求的概觀，請參閱《Amazon Simple Storage Service 使用者指南》中的查詢封存物件。

提出選取請求時，請執行下列動作：

如需搭配 Amazon Glacier Select 還原使用 SQL 的詳細資訊，請參閱《Amazon Simple Storage Service 使用者指南》中的 Amazon S3 Select 和 Amazon Glacier Select 的 SQL 參考。

提出選取請求時，您也可以執行下列動作：

以下是有關選取功能的其他重要事實：

還原封存

GLACIER 和 DEEP_ARCHIVE 儲存類別中的物件會封存。若要存取封存的物件，您必須先啟動還原請求。這會還原封存物件的暫時副本。在還原請求中，您可以指定要還原複本存在的天數。在指定的期間之後，Amazon S3 會刪除暫時複本，但物件會保留在還原物件的 GLACIER 或 DEEP_ARCHIVE 儲存類別中封存。

若要還原特定物件版本，您可以提供版本 ID。如果您未提供版本 ID，Amazon S3 會還原目前的版本。

還原任務完成所需的時間取決於物件正在還原的儲存體方案，以及您指定的資料存取層。

還原封存的物件 （或使用選取請求） 時，您可以在請求內文的 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 是封存物件上選取查詢的請求內文：

<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 狀態碼。

回應標頭

此操作的實作只會使用大多數回應通用的回應標頭。如需詳細資訊，請參閱常見回應標頭。

回應元素

此操作不會傳回回應元素。

特殊錯誤

範例

使用快速擷取選項還原物件兩天

下列還原請求會使用快速擷取選項，從 Amazon Glacier 還原photo1.jpg物件的副本兩天。

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 請求查詢封存

以下是範例選取還原請求。

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

詳細資訊