Object Storage Service:RestoreObject

前提条件

• 対象オブジェクトがアーカイブ、コールドアーカイブ、またはディープコールドアーカイブのいずれかのストレージクラスを使用していること。詳細については、「ストレージクラス」をご参照ください。

• oss:RestoreObject 権限を保有していること。「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。

注意事項

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

• オブジェクトに対して初めて RestoreObject 操作を呼び出すと、HTTP ステータスコード 202 Accepted が返されます。オブジェクトがすでに解凍状態にある場合、後続の呼び出しでは HTTP ステータスコード 200 OK が返されます。

• 現在復元中のオブジェクトに対して RestoreObject 操作を呼び出すことはできません。その場合、HTTP ステータスコード 409 Conflict エラーが返されます。再度操作を呼び出す前に、復元処理が完了するまでお待ちください。

• バージョン管理が有効なバケットでは、同一オブジェクトの異なるバージョンが異なるストレージクラスを持つことができます。デフォルトでは、RestoreObject 操作はオブジェクトの最新バージョンを復元します。特定のバージョンを復元するには、その versionId を指定してください。

復元プロセス

ストレージクラスが異なるオブジェクトであっても、復元プロセスは共通です。プロセスは以下のとおりです。

1. 初期状態では、オブジェクトは凍結ステータスにあります。

2. 復元リクエストを送信すると、オブジェクトは復元中ステータスになります。

3. サーバー側の処理が完了すると、オブジェクトは解凍状態になります。この状態になると、オブジェクトを読み取ることができます。

4. オブジェクトが解凍状態にあるときに再度復元リクエストを送信すると、解凍状態の持続時間が延長されます。ただし、延長後の合計期間は、該当ストレージクラスで許容される最大期間を超えることはできません。

5. 解凍状態の期間が終了すると、オブジェクトは再び凍結ステータスに戻ります。

復元時間

ストレージクラスごとのオブジェクト復元に必要な時間を次の表に示します。実際の復元時間は状況により異なる場合があります。

^①単一の Alibaba Cloud アカウントおよび単一リージョンにおけるコールドアーカイブオブジェクトの推定データ取得レートは、平均で 1 秒あたり 500 オブジェクトです。3 つの復元優先度すべてを合わせた 1 日あたりの合計取得量は 100 TB～120 TB です。ビジネス要件でこれ以上の取得レートが必要な場合は、テクニカルサポートにお問い合わせください。

^②単一の Alibaba Cloud アカウントおよび単一リージョンにおけるディープコールドアーカイブオブジェクトの推定データ取得レートは、平均で 1 秒あたり 100 オブジェクトです。2 つの復元優先度すべてを合わせた 1 日あたりの合計取得量は 10 TB～15 TB です。ビジネス要件でこれ以上の取得レートが必要な場合は、テクニカルサポートにお問い合わせください。

解凍状態の持続時間

オブジェクトが解凍状態を維持できる期間は、ストレージクラスによって異なります。

課金

• アーカイブ、コールドアーカイブ、およびディープコールドアーカイブのオブジェクトを復元すると、データ取得料金が発生します。詳細については、「データ処理料金」をご参照ください。

• アーカイブオブジェクトは最大 7 日間、コールドアーカイブおよびディープコールドアーカイブのオブジェクトは最大 365 日間、解凍状態を維持できます。この期間中は追加のデータ取得料金は発生しません。

• 解凍状態の期間が終了すると、オブジェクトは再び凍結ステータスに戻ります。再度オブジェクトを復元する場合は、データ取得料金が発生します。

• コールドアーカイブまたはディープコールドアーカイブのオブジェクトを復元すると、アクセスを可能にするために標準ストレージクラスのレプリカが作成されます。オブジェクトが解凍状態にある間、このレプリカの一時ストレージに対して標準ストレージクラスの料金が適用されます。詳細については、「一時ストレージ料金」をご参照ください。

リクエスト構文

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

リクエストヘッダー

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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

  成功時のレスポンス例

  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

• 復元中のアーカイブオブジェクトを復元する

  リクエスト例

  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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

  成功時のレスポンス例

  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>

• すでに解凍状態にあるアーカイブオブジェクトを復元する

  リクエスト例

  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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  <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

• すでに解凍状態にあるコールドアーカイブまたはディープコールドアーカイブのオブジェクトを復元する

  リクエスト例

  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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  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

• 特定のオブジェクトバージョンを復元する

  リクエスト例

  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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

  成功時のレスポンス例

  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

OSS SDK

以下の言語の OSS SDK を使用して RestoreObject を呼び出せます。

• Java

• Python V2

• PHP V2

• Go V2

• C

• C++

• .NET

• Android

• iOS

• Node.js

• Harmony

• Browser.js

ossutil

RestoreObject 操作に対応する ossutil コマンドの詳細については、「restore-object」をご参照ください。

エラーコード

参考資料

• 復元に必要な時間およびオブジェクトが解凍状態を維持できる日数の詳細については、「オブジェクトの復元」をご参照ください。

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

• OSS オブジェクトを恒久的に解凍状態に維持する方法の詳細については、「OSS オブジェクトを恒久的に復元する方法」をご参照ください。