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

Object Storage Service:restore(オブジェクトの解凍)

最終更新日:Mar 26, 2026

直接読み取りが有効になっていない場合、アーカイブストレージのオブジェクトは読み取り前に解凍する必要があります。コールドアーカイブストレージおよびディープコールドアーカイブストレージのストレージクラスでは直接読み取りがサポートされていません。したがって、これらのストレージクラスに格納されたオブジェクトは、読み取り前に必ず解凍する必要があります。アーカイブストレージのオブジェクトの解凍には通常数分、コールドアーカイブストレージのオブジェクトの解凍には通常数時間、ディープコールドアーカイブストレージのオブジェクトの解凍には通常 12 時間~48 時間かかります。実際の解凍時間は状況により異なります。本トピックでは、restore コマンドを使用したファイルの解凍方法について説明します。

考慮事項

  • 単一ファイルを解凍するには、oss:RestoreObject 権限が必要です。ディレクトリ単位でファイルを解凍するには、oss:RestoreObject 権限と oss:ListObjects 権限の両方が必要です。詳細については、「RAM ユーザーへのカスタム権限ポリシーの付与」をご参照ください。

  • アーカイブストレージ、コールドアーカイブストレージ、またはディープコールドアーカイブストレージ内のオブジェクトの解凍ステータスおよび料金に関する詳細は、「オブジェクトの解凍」をご参照ください。

コマンド構文

ossutil restore oss://bucket/object [flags]

パラメーター

説明

--days

int

解凍後のオブジェクトがアクセス可能である期間(日数)。有効な値:1~365。

異なるストレージクラスのオブジェクトに対してバッチ操作を実行する場合、指定した日数がそのストレージクラスで許容される最大値を超えると、自動的にそのクラスの最大値に調整されます。たとえば、アーカイブストレージの最大期間は 7 日、ディープコールドアーカイブストレージの最大期間は 365 日です。--days を 100 に設定した場合、アーカイブストレージのオブジェクトについては期間が自動的に 7 日に調整され、ディープコールドアーカイブストレージのオブジェクトについては 100 日のままとなります。

--tier

string

解凍優先度。アーカイブストレージのオブジェクトについてはこのパラメーターは必須ではありません(解凍完了まで約 1 分かかるため)。

  • コールドアーカイブストレージ:

    • [高速]:復元が 1 時間以内に完了します。

    • 標準: 復元は 2~5 時間で完了します。

    • 一括: 復元は5~12時間以内に完了します。

  • ディープコールドアーカイブストレージ:

    • [迅速対応]: 復元は 12 時間以内に完了します。

    • 標準: 復元は 48 時間以内に完了します。

異なるストレージクラスのオブジェクトをバッチで解凍する場合、指定した優先度が特定のクラスでサポートされていない場合は、自動的にそのクラスでサポートされる最低の優先度に調整されます。たとえば、コールドアーカイブストレージでは Bulk 優先度がサポートされていますが、ディープコールドアーカイブストレージでは Standard 優先度のみがサポートされています。--tier を Bulk に設定した場合、バッチ内のディープコールドアーカイブストレージのオブジェクトについては、優先度が自動的に Standard に調整されます。

--dirs

/

指定されたディレクトリ内のオブジェクトおよびサブディレクトリを再帰的ではなく一覧表示します。

--encoding-type

string

処理対象のオブジェクトまたはファイル名のエンコーディング方式。有効な値:url。

--end-with

string

アルファベット順で指定された値以下(含む)のオブジェクトを一覧表示します。

--exclude

stringArray

パスまたはオブジェクト名の除外ルール。

--exclude-from

stringArray

除外ルールをファイルから読み込みます。

--files-from

stringArray

ソースファイル名の一覧をファイルから読み込みます。空行およびコメント行は無視されます。

--files-from-raw

stringArray

ソースファイル名の一覧をファイルから読み込みます。

--filter

stringArray

パスまたはオブジェクト名のフィルタールール。

--filter-from

stringArray

フィルタールールをファイルから読み込みます。

-f, --force

/

確認プロンプトを表示せずに操作を強制実行します。

--include

stringArray

パスまたはオブジェクト名の包含ルール。

--include-from

stringArray

包含ルールをファイルから読み込みます。

--limited-num

int

返される結果の最大数。

--list-objects

/

ListObjects 操作を使用してオブジェクトを一覧表示します。

--min-age

Duration

指定された値より新しいオブジェクトを除外します。デフォルトの単位は秒です。単位接尾辞(例:1 時間の場合は 1h)も使用できます。

説明

--min-age 1h は、1 時間以上前に変更されたファイルのみが転送されることを示します。

--max-age

Duration

指定された値より古いオブジェクトを除外します。デフォルトの単位は秒です。単位接尾辞(例:1 時間の場合は 1h)も使用できます。

--min-mtime

Time

指定された時刻より前に変更されたオブジェクトを除外します。時刻は協定世界時 (UTC) 形式で指定する必要があります(例:2006-01-02T15:04:05)。

説明

--min-mtime "2006-01-02T15:04:05" は、2006 年 1 月 2 日 15 時 4 分 5 秒以降に変更されたファイルのみを転送することを意味します。

--max-mtime

Time

指定された時刻より後に変更されたオブジェクトを除外します。時刻は協定世界時 (UTC) 形式で指定する必要があります(例:2006-01-02T15:04:05)。

--max-size

SizeSuffix

解凍対象のオブジェクトの最大サイズ。デフォルトの単位はバイトです。B、K、M、G、T、P などの接尾辞を使用できます。1 K(KiB)=1,024 バイトです。

--metadata-exclude

stringArray

オブジェクトのメタデータの除外ルール。

--metadata-filter

stringArray

オブジェクトのメタデータのフィルタールール。

--metadata-filter-from

stringArray

オブジェクトのメタデータのフィルタールールをファイルから読み込みます。

--metadata-include

stringArray

オブジェクトのメタデータの包含ルール。

--min-size

SizeSuffix

解凍対象のオブジェクトの最小サイズ。デフォルトの単位はバイトです。B、K、M、G、T、P などの接尾辞を使用できます。1 K(KiB)=1,024 バイトです。

--page-size

int

バッチ操作における 1 ページあたりの最大オブジェクト数。デフォルト値:1000。有効な値:1~1000。

-r, --recursive

/

指定されたプレフィックス以下のすべての一致するオブジェクトに対して、再帰的に操作を実行します。このオプションを指定しない場合、コマンドは指定されたオブジェクトのみに適用されます。

--request-payer

string

リクエストの支払者を指定します。Requester Pays モードのバケットでは、requester を設定します。

--start-after

string

アルファベット順で指定された値より後(その値を含まない)のオブジェクトを一覧表示します。

--version-id

string

オブジェクトのバージョン ID。

--list-format

string

リストファイルのフォーマット。有効な値:plain、inventory。

--list-manifest-from

string

マニフェストファイルからリストファイルのフォーマットの説明を読み込みます。--list-formatinventory に設定した場合、このパラメーターは必須です。

説明

詳細については、「コマンドライン オプション」をご参照ください。

実行例

アーカイブストレージ

  • 次のコマンドは、バケット examplebucket からオブジェクト exampleobject.txt を解凍します。

    ossutil restore oss://examplebucket/exampleobject.txt
  • 次のコマンドは、バケット examplebucket からオブジェクト exampleobject.txt を解凍し、解凍期間を 3 日間に設定します。

    ossutil restore oss://examplebucket/exampleobject.txt --days 3
  • リストファイルからオブジェクトを復元する。

    説明

    リストファイルの各行には、OSS パス形式 oss://{bucket}/{key} で 1 つのオブジェクトが指定されます。たとえば、list.txt ファイルの内容は以下のとおりです。

    oss://examplebucket/key1
    oss://examplebucket/key2
    ossutil restore list://list.txt
  • オブジェクトのステータスを確認せずに、リストファイルからオブジェクトを復元します。

    ossutil restore list://list.txt --no-check-status 
  • 在庫ファイルからオブジェクトを復元します。

    説明

    インベントリジョブが完了すると、csv.gz ファイルと manifest.json ファイルが生成されます。インベントリファイルからオブジェクトを解凍するには、両方のファイルが必要です。

    ossutil restore list://ca8007fc-4123-493e-9a01-dd1511fbac54.csv.gz --list-format inventory --list-manifest-from manifest.json
  • オブジェクトのステータスを確認せずに、在庫ファイルからオブジェクトを復元します。

    ossutil restore list://ca8007fc-4123-493e-9a01-dd1511fbac54.csv.gz --list-format inventory --list-manifest-from manifest.json --no-check-status

コールドアーカイブストレージ

次のコマンドは、バケット examplebucket からコールドアーカイブストレージのオブジェクト exampleobject.txt を解凍し、解凍期間を 5 日間に設定します。

ossutil restore oss://examplebucket/exampleobject.txt --tier Bulk --days 5

次のコマンドは、バケット examplebucketdir/ プレフィックス配下にあるすべてのコールドアーカイブストレージの .csv オブジェクトを再帰的に解凍します。解凍期間は 5 日間に設定されます。

ossutil restore oss://examplebucket/dir/ -r --include "*.csv" --tier Bulk --days 5

ディープコールドアーカイブストレージ

次のコマンドは、バケット examplebucket からディープコールドアーカイブストレージのオブジェクト exampleobject.txt を解凍し、解凍期間を 10 日間に設定します。

ossutil restore oss://examplebucket/exampleobject.txt --tier Standard --days 10

次のコマンドは、バケット examplebucketdir/ プレフィックス配下にあるすべてのディープコールドアーカイブストレージの .csv オブジェクトを再帰的に解凍します。解凍期間は 10 日間に設定されます。

ossutil restore oss://examplebucket/dir/ -r --include "*.csv" --tier Standard --days 10

課金

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

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

  • 解凍状態の有効期限が切れた後、オブジェクトは凍結ステータスに戻ります。再度オブジェクトを解凍する場合、データ取得料金が発生します。

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