Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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 请求时，请执行以下操作：

有关将 SQL 与 Amazon Glacier Select 还原结合使用的更多信息，请参阅《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 天后删除该对象。有关生命周期配置的更多信息，请参阅 PutBucketLifecycleConfiguration 和《Amazon Simple Storage Service 用户指南》中的对象生命周期管理。

请求

语法

POST /ObjectName?restore&versionId=VersionID HTTP/1.1
Host: BucketName.s3.amazonaws.com
Date: date
Authorization: authorization string (see 对请求进行身份验证（Amazon 签名版本 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 状态代码。

响应标头

此操作的实施仅使用大多数响应通用的响应标头。有关更多信息，请参阅通用响应标头。

响应元素

此操作不返回响应元素。

特殊错误

示例

使用加速检索选项还原对象，为期两天

以下还原请求使用加速检索选项从 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 请求查询归档

以下是 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

更多信息