すべてのプロダクト
Search

このプロダクト

    Object Storage Service:restore-object

    ドキュメントセンター

    Object Storage Service:restore-object

    最終更新日:Nov 09, 2025

    restore-object コマンドは、アーカイブまたはコールドアーカイブオブジェクトを解凍します。

    使用上の注意

    • デフォルトでは、Alibaba Cloud アカウントはオブジェクトを解凍する権限を持っています。Resource Access Management (RAM) ユーザーとして、またはセキュリティトークンサービス (STS) トークンを使用してオブジェクトを解凍するには、oss:RestoreObject 権限が必要です。詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。

    • restore-object コマンドは、アーカイブまたはコールドアーカイブオブジェクトにのみ適用されます。このコマンドは、標準または低頻度アクセス (IA) オブジェクトには適用されません。

    • アーカイブまたはコールドアーカイブオブジェクトを読み取るには、まずオブジェクトを解凍する必要があります。アーカイブオブジェクトの解凍には約 1 分かかります。コールドアーカイブオブジェクトの解凍には数時間かかる場合があります。

    課金

    オブジェクトを解凍すると、ストレージ料金、データ取得料金、およびリクエスト料金が発生します。コールドアーカイブまたはディープコールドアーカイブオブジェクトを解凍する場合、一時的なストレージ料金も発生します。

    • ストレージ料金: アーカイブ、コールドアーカイブ、およびディープコールドアーカイブオブジェクトのストレージ料金は、解凍中および解凍後、それぞれのストレージタイプに基づいて計算されます。詳細については、「ストレージ料金」をご参照ください。

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

    • リクエスト料金:

      • アーカイブオブジェクトを解凍すると、PUT リクエストの料金が発生します。詳細については、「リクエスト料金」をご参照ください。

      • コールドアーカイブまたはディープコールドアーカイブオブジェクトを解凍すると、取得リクエストの料金が発生します。詳細については、「リクエスト料金」をご参照ください。

    • 一時的なストレージ料金: コールドアーカイブまたはディープコールドアーカイブオブジェクトを解凍すると、アクセスを許可するためにオブジェクトのレプリカが作成されます。このレプリカには、解凍状態が有効期限切れになるまで、標準ストレージタイプのレートで一時的なストレージ料金が発生します。詳細については、「一時的なストレージ料金」をご参照ください。

    プロセス

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

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

    2. オブジェクトを解凍するリクエストを送信すると、オブジェクトは解凍中の状態になります。

    3. OSS サーバーが解凍タスクを完了すると、オブジェクトは解凍状態になり、アクセスできるようになります。

    4. 解凍状態のオブジェクトに対して別の解凍リクエストを開始して、解凍状態の期間を延長できます。解凍状態の期間は、対応するストレージタイプでサポートされている最大期間を超えることはできません。

    5. 解凍状態の期間が終了すると、オブジェクトはストレージタイプを変更せずに凍結ステータスに戻ります。

    復元時間

    次の表に、さまざまなストレージタイプのオブジェクトを解凍するために必要な時間を示します。記載されている解凍時間は参考用です。実際の解凍時間は、特定のシナリオによって異なる場合があります。

    ストレージタイプ

    説明

    アーカイブ

    1 分。

    コールドアーカイブ

    • 迅速: オブジェクトは 1 時間以内に解凍されます。

    • 標準: オブジェクトは 2 ～ 5 時間以内に解凍されます。

    • バルク: オブジェクトは 5 ～ 12 時間以内に解凍されます。

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

    • 迅速: オブジェクトは 12 時間以内に解凍されます。

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

    解凍クォータ

    • リージョン内の Alibaba Cloud アカウントのコールドアーカイブオブジェクトを解凍するための参照クォータ: 1 秒あたり平均 500 オブジェクト、3 つすべての解凍優先度で 1 日あたり合計 100 TB ～ 120 TB。ビジネスでより高い解凍クォータが必要な場合は、テクニカルサポートにお問い合わせください。

    • リージョン内の Alibaba Cloud アカウントのディープコールドアーカイブオブジェクトを解凍するための参照クォータ: 1 秒あたり平均 100 オブジェクト、両方の解凍優先度で 1 日あたり合計 10 TB ～ 15 TB。ビジネスでより高い解凍クォータが必要な場合は、テクニカルサポートにお問い合わせください。

    説明

    コールドアーカイブおよびディープコールドアーカイブオブジェクトの参照クォータを超えた後でも、解凍リクエストを送信できます。解凍リクエストはキューに入れられ、解凍タスクの完了に必要な時間は、選択した優先度に対応する予想時間よりも長くなる場合があります。

    解凍状態の期間

    次の表に、さまざまなストレージタイプのオブジェクトの解凍状態の期間を示します。

    ストレージタイプ

    説明

    アーカイブ

    1 から 7 までの整数。単位: 日。

    コールドアーカイブ

    1 から 365 までの整数。単位: 日。

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

    1 から 365 までの整数。単位: 日。

    コマンド構文

    ossutil api restore-object --bucket value --key value [flags]

    パラメーター

    タイプ

    説明

    --bucket

    string

    バケットの名前。

    --key

    string

    オブジェクトの完全なパス。

    --restore-request

    string

    復元リクエスト情報。

    --version-id

    string

    解凍するオブジェクトのバージョン ID。

    説明

    restore-object コマンドは RestoreObject API 操作に対応します。この API 操作のパラメーターの詳細については、「RestoreObject」をご参照ください。

    --restore-request

    --restore-request 設定オプションは、XML と JSON の両方の構文をサポートします。オプションの値に file:// プレフィックスが含まれている場合、設定は指定されたローカルファイルから読み取られます。

    • XML 構文:

      <RestoreRequest>
  <Days>integer</Days>
  <JobParameters>
    <Tier>string</Tier>
  </JobParameters>
</RestoreRequest>

    • JSON 構文:

      {
  "Days": integer,
  "JobParameters": {
    "Tier": "string"
  }
}
    説明

    サポートされているグローバルコマンドラインオプションの詳細については、「サポートされているグローバルコマンドラインオプション」をご参照ください。

    例

    アーカイブオブジェクトの解凍

    次の例は、examplebucket バケットから exampleobject という名前のアーカイブオブジェクトを解凍する方法を示しています。

    • XML 設定ファイルを使用します。次のコードは、restore-request.xml の内容を示しています。

      <?xml version="1.0" encoding="UTF-8"?>
<RestoreRequest>
  <Days>2</Days>
</RestoreRequest>

      コマンドの例:

      ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request file://restore-request.xml

    • JSON 設定ファイルを使用します。次のコードは、restore-request.json の内容を示しています。

      {
  "Days": "2"
}

      コマンドの例:

      ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request file://restore-request.json

    • JSON 設定パラメーターを使用します。コマンドの例:

      ossutil api restore-object  --bucket examplebucket --key exampleobject --restore-request "{\"Days\":\"2\"}"

    コールドアーカイブまたはディープコールドアーカイブオブジェクトの解凍

    次の例は、examplebucket バケットから exampleobject という名前のコールドアーカイブオブジェクトを解凍する方法を示しています。

    • XML 設定ファイルを使用します。次のコードは、restore-request.xml の内容を示しています。

      <?xml version="1.0" encoding="UTF-8"?>
<RestoreRequest>
  <Days>2</Days>
  <JobParameters>
    <Tier>Standard</Tier>
  </JobParameters>
</RestoreRequest>

      コマンドの例:

      ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request file://restore-request.xml

    • JSON 設定ファイルを使用します。次のコードは、restore-request.json の内容を示しています。

      {
  "Days": "2",
  "JobParameters": {
    "Tier": "Standard"
  }
}

      コマンドの例:

      ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request file://restore-request.json

    • JSON 設定パラメーターを使用します。コマンドの例:

      ossutil api restore-object  --bucket examplebucket --key exampleobject --restore-request "{\"Days\":\"2\",\"JobParameters\":{\"Tier\":\"Standard\"}}"

    関連する API 操作

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