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

詳細