Object Storage Service:RestoreObject

前提条件

• 復元するオブジェクトのストレージクラスは、アーカイブ、コールドアーカイブ、またはディープコールドアーカイブです。 詳細については、「概要」をご参照ください。

• oss:RestoreObject権限が付与されています。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

使用上の注意

• RestoreObject操作は、アーカイブ、コールドアーカイブ、およびディープコールドアーカイブオブジェクトにのみ適用されます。 この操作は、標準または低頻度アクセス (IA) オブジェクトには適用されません。

• DeleteObject、DeleteMultipleObjects、GetObjectMeta、HeadObjectなどの非アクセス操作をArchive、Cold Archive、Deep Cold Archiveオブジェクトで呼び出す場合、オブジェクトを復元する必要はありません。 上記の操作では、オブジェクトが復元されると不要な料金が発生します。

• アーカイブオブジェクト、Cold Archiveオブジェクト、またはDeep Cold Archiveオブジェクトに対して初めてRestoreObject操作を呼び出すと、HTTPステータスコード202が返されます。 復元されたオブジェクトに対してRestoreObject操作を呼び出すと、200 OKが返されます。

• 復元状態のオブジェクトに対してRestoreObject操作を呼び出すと、操作は失敗し、HTTPステータスコード409が返されます。 オブジェクトが復元された後、オブジェクトに対してRestoreObject操作を再度呼び出すことができます。

• バージョン管理が有効なバケットでは、オブジェクトの異なるバージョンのストレージクラスが異なる場合があります。 既定では、オブジェクトに対してRestoreObject操作を呼び出すと、オブジェクトの現在のバージョンが復元されます。 リクエストでバージョンIDを指定して、オブジェクトの特定のバージョンを復元できます。

処理中

次の復元プロセスは、アーカイブ、コールドアーカイブ、およびディープコールドアーカイブオブジェクトに適用されます。

1. 最初は、オブジェクトは凍結状態にある。

2. オブジェクトを復元するための要求が送信された後、オブジェクトは復元状態に入ります。

3. OSSサーバーが復元タスクを完了すると、オブジェクトは復元された状態になり、アクセスできます。

4. 復元された状態のオブジェクトに対して別の復元要求を開始して、オブジェクトの復元された状態の期間を延長できます。 オブジェクトの復元された状態の期間は、対応するストレージクラスでサポートされている最大期間を超えることはできません。

5. 復元された状態の期間が終了すると、オブジェクトは凍結状態に戻ります。

復元時間

次の表に、異なるストレージクラスのオブジェクトを復元するために必要な時間を示します。 与えられた回復時間は参照用である。 復元時間は、実際のシナリオに基づいて変化し得る。

取得されたオブジェクトの量の参照値

• 1つのリージョンのAlibaba Cloudアカウント内で取得されるCold Archiveオブジェクトの量の参照値: 1つのリージョンで、Alibaba Cloudアカウントは1秒あたり平均500個のCold Archiveオブジェクトを取得できます。 前の優先順位の取得されたデータの合計量は、1日あたり100テラバイトから120テラバイトの範囲です。 より高い要件がある場合は、チケットを起票し、サポートセンターにお問い合わせください。

• 1つのリージョンのAlibaba Cloudアカウント内で取得されたdeep Cold Archiveオブジェクトの量の参照値: 1つのリージョンで、Alibaba Cloudアカウントは1秒あたり平均100個のDeep Cold Archiveオブジェクトを取得できます。 前の優先順位の取得されたデータの合計量は、1日あたり10テラバイトから15テラバイトの範囲です。 より高い要件がある場合は、お問い合わせください チケットを起票し、サポートセンターにお問い合わせください。

復元された状態の期間

次の表に、さまざまなストレージクラスのオブジェクトの復元状態の期間を示します。

課金ルール

• 復元されたアーカイブ、コールドアーカイブ、またはディープコールドアーカイブオブジェクトのサイズに基づいて、データ取得料金が請求されます。 詳細については、「データ処理料金」をご参照ください。

• Archiveオブジェクトを復元するときに、PUTリクエストの数に基づいてAPI操作呼び出し料金が請求されます。 詳細については、「API 操作呼び出し料金」をご参照ください。

• Cold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトを復元すると、データ取得要求が課金されます。 詳細については、「API 操作呼び出し料金」をご参照ください。

• 復元中および復元後のアーカイブ、コールドアーカイブ、およびディープコールドアーカイブオブジェクトの課金ルールに基づいてストレージ料金が請求されます。 詳細については、「ストレージ料金」をご参照ください。

• Cold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトを復元すると、一時的なアクセス用にオブジェクトの標準レプリカが生成されます。 Cold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトが凍結状態に戻るまで、標準ストレージクラスに基づくレプリカの一時ストレージに対して課金されます。 詳細については、「一時ストレージ料金」をご参照ください。

• アーカイブオブジェクトは、最大7日間復元された状態を維持できます。 Cold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトは、最大365日間復元された状態を維持できます。 オブジェクトが復元された状態の場合、データ取得料金は請求されません。

• オブジェクトが復元状態にある期間が終了すると、オブジェクトは凍結状態に戻る。 凍結状態に戻った後にオブジェクトを復元すると、データ取得料金が発生します。

リクエスト構文

POST /ObjectName?restore HTTP/1.1
Host: archive-bucket.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

リクエストヘッダー

RestoreObjectリクエストのリクエストヘッダーは、一般的なリクエストヘッダーのみです。 詳細については、「共通リクエストヘッダー」をご参照ください。

リクエストパラメーター

レスポンスヘッダー

RestoreObject要求に対する応答には、共通の応答ヘッダが含まれる。 詳細については、「共通レスポンスヘッダー」をご参照ください。

例

• 凍結状態のアーカイブオブジェクトに対するRestoreObjectリクエストを初めて開始します。

  リクエストの例

  POST /oss.jpg?restore HTTP/1.1
  Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
  Date: Sat, 15 Apr 2017 07:45:28 GMT
  Authorization: OSS qn6q**************:77Dv****************

  通常のレスポンス例

  HTTP/1.1 202 Accepted
  Date: Sat, 15 Apr 2017 07:45:28 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS
  x-oss-request-id: 5374A2880232A65C23002D74

• 復元状態のアーカイブオブジェクトに対するRestoreObjectリクエストの開始

  リクエストの例

  POST /oss.jpg?restore HTTP/1.1
  Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
  Date: Sat, 15 Apr 2017 07:45:29 GMT
  Authorization: OSS qn6q**************:77Dv****************

  通常のレスポンス例

  HTTP/1.1 409 Conflict
  Date: Sat, 15 Apr 2017 07:45:29 GMT
  Content-Length: 556
  Connection: keep-alive
  Server: AliyunOSS
  x-oss-request-id: 5374A2880232A65C23002D74
  <?xml version="1.0" encoding="UTF-8"?>
  <Error>
    <Code>RestoreAlreadyInProgress</Code>
    <Message>The restore operation is in progress.</Message>
    <RequestId>58EAF141461FB42C2B000008</RequestId>
    <HostId>10.101.XX.XX</HostId>
  </Error>

• 復元された状態のアーカイブオブジェクトに対するRestoreObjectリクエストの開始

  リクエストの例

  POST /oss.jpg?restore HTTP/1.1
  Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
  Date: Sat, 15 Apr 2017 07:45:29 GMT
  Authorization: OSS qn6q**************:77Dv****************
  <RestoreRequest>
    <Days>2</Days>
  </RestoreRequest>

  通常のレスポンス例

  HTTP/1.1 200 Ok
  Date: Sat, 15 Apr 2017 07:45:30 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS
  x-oss-request-id: 5374A2880232A65C23002D74

• 復元された状態のCold ArchiveオブジェクトまたはDeep Cold ArchiveオブジェクトのRestoreObjectリクエストを開始する

  リクエストの例

  POST /coldarchiveobject?restore HTTP/1.1
  Host: cold-archive-bucket.oss-cn-hangzhou.aliyuncs.com
  User-Agent: aliyun-sdk-go/v2.1.0 (Darwin/17.5.0/x86_64;go1.11.8)/ossutil-v1.6.12
  Content-Length: 99
  Authorization: OSS qn6q**************:77Dv****************
  Content-Type: text/plain; charset=utf-8
  Date: Tue, 21 Apr 2020 11:09:19 GMT
  Accept-Encoding: gzip
  <RestoreRequest>
    <Days>2</Days>
    <JobParameters>
      <Tier>Standard</Tier>
    </JobParameters>
  </RestoreRequest>

  通常のレスポンス例

  HTTP/1.1 200 OK
  Server: AliyunOSS
  Date: Tue, 21 Apr 2020 11:09:19 GMT
  Content-Length: 0
  Connection: keep-alive
  x-oss-request-id: 5E9ED45F093E2F3930318EA0
  x-oss-object-restore-priority: Standard
  x-oss-server-time: 10

• RestoreObject操作を呼び出してオブジェクトを復元するときのバージョンIDを指定します。

  リクエストの例

  POST /oss.jpg?restore&versionId=CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh**** HTTP/1.1
  Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 06:50:48 GMT
  Authorization: OSS qn6q**************:77Dv****************

  通常のレスポンス例

  HTTP/1.1 202 Accepted
  Date: Tue, 09 Apr 2019 06:50:48 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS
  x-oss-version-id: CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh****
  x-oss-request-id: 5CAC40C8B7AEADE017000653

SDK

次のプログラミング言語のOSS SDKを使用して、RestoreObject操作を呼び出すことができます。

• Java

• Python

• PHP

• Go

• C

• C ++

• . NET

• アンドロイド

• iOS

• Node.js

エラーコード

関連ドキュメント

• 復元に必要な時間と、オブジェクトが復元された状態のままである日数の詳細については、「オブジェクトの復元」をご参照ください。

• ossutilを使用してオブジェクトを復元する方法の詳細については、「restore」をご参照ください。

• 復元された状態のオブジェクトを永続的に保持する方法の詳細については、「オブジェクトを復元された状態で永続的に作成するにはどうすればよいですか? 」をご参照ください。