すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:RestoreObject

最終更新日:Feb 23, 2024

アーカイブオブジェクトのリアルタイムアクセスを有効にするか、復元後にアーカイブオブジェクトにアクセスできます。 リアルタイムアクセスは、Cold ArchiveオブジェクトとDeep Cold Archiveオブジェクトではサポートされていません。 Cold ArchiveオブジェクトとDeep Cold Archiveオブジェクトは、復元後にのみアクセスできます。 ほとんどの場合、アーカイブオブジェクトの復元は完了するまでに数分かかり、コールドアーカイブオブジェクトの復元は完了するまでに数時間かかり、ディープコールドアーカイブオブジェクトの復元は完了するまでに12〜48時間かかります。 与えられた回復時間は参照用である。 復元時間は、実際のシナリオに基づいて変化し得る。 このトピックでは、RestoreObject操作を呼び出して、アーカイブ、コールドアーカイブ、およびディープコールドアーカイブオブジェクトを復元する方法について説明します。

処理中

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

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

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

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

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

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

使用上の注意

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

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

  • 復元状態のオブジェクトに対するRestoreObject操作は、HTTP 409エラーコードで失敗します。 オブジェクトの復元後、オブジェクトに対して別のRestoreObject操作を正常に呼び出すことができます。

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

課金ルール

  • Archive、Cold Archive、およびDeep Cold Archiveオブジェクトを復元すると、データ取得料金が発生します。 詳細については、「データ処理料金」をご参照ください。

  • アーカイブオブジェクトは最大7日間復元された状態を維持でき、コールドアーカイブまたはディープコールドアーカイブオブジェクトは最大365日間復元された状態を維持できます。 プロセス中にデータ取得料金が再度請求されることはありません。

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

  • 復元中および復元後のアーカイブオブジェクトの課金ルールに基づいて、アーカイブオブジェクトに対して課金されます。

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

リクエスト構文

POST /ObjectName? HTTP/1.1の復元
ホスト: archive-bucket.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue 

リクエストヘッダー

このAPI操作に含まれるリクエストヘッダーには、共通のリクエストヘッダーのみが含まれます。 詳細については、「共通リクエストヘッダー」をご参照ください。

リクエストパラメーター

ヘッダー

データ型

必須

説明

RestoreRequest

Container

必須

N/A

RestoreObjectリクエストに関する情報を格納するコンテナー。

子ノード: DaysとJobParameters

Integer

必須

2

オブジェクトが復元された状態のままである期間。

  • アーカイブオブジェクトの有効な値: 1 ~ 7。 単位:日

  • Cold ArchiveオブジェクトとDeep Cold Archiveオブジェクトの有効な値: 1 ~ 365。 単位:日

親ノード: RestoreRequest

JobParameters

Container

任意

N/A

復元の優先度を格納するコンテナー。 このパラメーターは、Cold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトを復元する場合にのみ有効です。

JobParametersパラメーターを指定しない場合は、デフォルトの復元優先度標準が使用されます。

親ノード: RestoreRequest

子ノード: 階層

ティア

String

任意

標準

Cold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトの復元優先度。 デフォルト値: Standard。 有効な値:

  • コールドアーカイブ

    • 回避: オブジェクトは1時間以内に復元されます。

    • 標準: オブジェクトは2〜5時間以内に復元されます。

    • バルク: オブジェクトは5〜12時間以内に復元されます。

  • ディープコールドアーカイブ

    • 回避: オブジェクトは12時間以内に復元されます。

    • 標準: オブジェクトは48時間以内に復元されます。

親ノード: JobParameters

レスポンスヘッダー

ヘッダー

データ型

説明

x-oss-object-restore-priority

String

標準

復元の優先順位。 このヘッダーは、復元された状態のCold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトに対してのみ表示されます。

x-oss-version-id

String

CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh ****

オブジェクトのバージョンID。 このヘッダーは、リクエストでオブジェクトのバージョンIDが指定されている場合にのみ表示されます。

このAPI操作に含まれるレスポンスヘッダーには、共通のレスポンスヘッダーが含まれます。 詳細については、「共通レスポンスヘッダー」をご参照ください。

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

    リクエストの例

    POST /oss.jpg? HTTP/1.1の復元
    ホスト: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
    日付: 4月15日土曜日07:45:28 GMT 2017
    承認: OSS e1Unnbm1rg ****:y4eyu + 4yje5ioRCr **** 

    レスポンスの例

    HTTP/1.1 202受け入れ
    日付: 4月15日土曜日07:45:28 GMT 2017
    コンテンツ長: 0
    接続: キープアライブ
    サーバー: AliyunOSS
    x-oss-request-id: 5374A2880232A65C23002D7 4 
  • 復元状態のアーカイブオブジェクトに対するRestoreObjectリクエストの開始

    リクエストの例

    POST /oss.jpg? HTTP/1.1の復元
    ホスト: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
    日付: 4月15日土曜日07:45:29 GMT 2017
    承認: OSS e1Unnbm1rg ****:21qtGJ + ykDVmdy4eyu + N **** 

    レスポンスの例

    HTTP/1.1 409競合
    日付: 4月15日土曜日07:45:29 GMT 2017
    コンテンツ-長さ: 556
    接続: キープアライブ
    サーバー: AliyunOSS
    x-oss-request-id: 5374A2880232A65C23002D74
    <?xml version="1.0" encoding="UTF-8"?>
    <エラー>
      <Code>RestoreAlreadyInProgress</Code>
      <メッセージ> 復元操作が進行中です。</Message>
      <RequestId>58EAF141461FB42C2B000008</RequestId>
      <HostId>10.101.XX.XX</HostId>
    </エラー> 
  • 復元された状態のアーカイブオブジェクトに対するRestoreObjectリクエストの開始

    リクエストの例

    POST /oss.jpg? HTTP/1.1の復元
    ホスト: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
    日付: 4月15日土曜日07:45:29 GMT 2017
    承認: OSS e1Unnbm1rg ****:u6O6FMJnn + WuBwbByZxm1 + y4eyu + N ****
    <RestoreRequest>
      <日> 2</日>
    </RestoreRequest> 

    レスポンスの例

    HTTP/1.1 200 Ok
    日付: 4月15日 (土) 2017 07:45:30 GMT
    コンテンツ長: 0
    接続: キープアライブ
    サーバー: AliyunOSS
    x-oss-request-id: 5374A2880232A65C23002D7 4 
  • 復元された状態のCold ArchiveオブジェクトまたはDeep Cold ArchiveオブジェクトのRestoreObjectリクエストを開始する

    リクエストの例

    POST /coldarchiveobject? HTTP/1.1の復元
    ホスト: cold-archive-bucket.oss-cn-hangzhou.aliyuncs.com
    ユーザーエージェント: aliyun-sdk-go/v2.1.0 (Darwin/17.5.0/x86_64;go1.11.8)/ossutil-v1.6.12
    コンテンツ-長さ: 99
    承認: OSS LTAI4FjmjjhjiYK6kMaV ****:Gi1x7YHqTw + NQCJo0fKBHcYQ ****
    Content-Type: text/plain; charset=utf-8
    日付: 4月2020日火曜日11:09:19 GMT
    受け入れる-エンコーディング: gzip
    <RestoreRequest>
      <Days>2</Days>
      <JobParameters>
        <Tier> スタンダード </Tier>
      </JobParameters>
    </RestoreRequest> 

    レスポンスの例

    HTTP/1.1 200 OK
    サーバー: AliyunOSS
    日付: 4月2020日火曜日11:09:19 GMT
    コンテンツ長: 0
    接続: キープアライブ
    x-oss-request-id: 5E9ED45F093E2F3930318EA0
    x-oss-object-restore-priority: 標準
    x-oss-server-time: 10 
  • RestoreObject操作を呼び出してオブジェクトを復元するときのバージョンIDを指定します。

    リクエストの例

    POST /oss.jpg?restore&versionId=CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh **** HTTP/1.1
    ホスト: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
    日付: 4月2019日火曜日06:50:48 GMT
    承認: OSS o3shiyktjw1 ****:2JND5qqlAlaA 1/kLO4kBbGTw **** 

    レスポンスの例

    HTTP/1.1 202受け入れ
    日付: 4月2019日火曜日06:50:48 GMT
    コンテンツ長: 0
    接続: キープアライブ
    サーバー: AliyunOSS
    x-oss-version-id: CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh ****
    x-oss-request-id: 5CAC40C8B7AEADE01700065 3 

SDK

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

エラーコード

エラーコード

HTTPステータスコード

説明

OperationNotSupported

400

オブジェクトのストレージクラスがArchive、Cold Archive、またはDeep Cold Archiveではないため、オブジェクトを復元できません。

NoSuchKey

404

指定されたオブジェクトは存在しません。

RestoreAlreadyInProgress

409

RestoreObject操作が進行中です。 RestoreObject操作を繰り返し呼び出さないでください。

参考資料