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

Object Storage Service:restore

最終更新日:Oct 29, 2026

アーカイブオブジェクトのリアルタイムアクセスが有効になっていない場合、アーカイブオブジェクトは解凍後にのみ読み取り可能です。コールドアーカイブまたはディープコールドアーカイブのオブジェクトはリアルタイムアクセスをサポートしていないため、これらのオブジェクトは解凍後にのみ読み取り可能です。アーカイブオブジェクトの解凍には通常数分、コールドアーカイブオブジェクトの解凍には通常数時間、ディープコールドアーカイブオブジェクトの解凍には通常 12 時間から 48 時間かかります。これらの時間は推定値であり、実際の解凍時間は異なる場合があります。このトピックでは、restore コマンドを実行してオブジェクトを解凍する方法について説明します。

注意事項

  • 単一のオブジェクトを解凍するには、oss:RestoreObject 権限が必要です。ディレクトリ別にオブジェクトを解凍するには、oss:RestoreObject および oss:ListObjects 権限が必要です。詳細については、「カスタムポリシーの付与」をご参照ください。

  • アーカイブ、コールドアーカイブ、ディープコールドアーカイブオブジェクトの解凍ステータスと課金ルールに関する詳細については、「オブジェクトの解凍」をご参照ください。

コマンド構文

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

パラメーター

タイプ

説明

--days

int

オブジェクトが解凍状態で保持される日数。有効値:1~365。

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

説明

--days 3 は、オブジェクトが解凍後 3 日間読み取り可能であることを指定します。

--tier

string

解凍優先度。アーカイブオブジェクトは 1 分で解凍されるため、このパラメーターを指定する必要はありません。

  • コールドアーカイブ:

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

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

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

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

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

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

混合ストレージクラスのオブジェクトに対してバッチ操作を実行する場合、--tier の値がストレージクラスでサポートされている優先度を超えると、その値はそのストレージクラスでサポートされている最も低い優先度に自動的に調整されます。たとえば、コールドアーカイブは Bulk をサポートし、ディープコールドアーカイブは Standard のみをサポートします。--tier を Bulk に設定した場合、ディープコールドアーカイブオブジェクトの値は自動的に Standard に調整されます。

説明

--tier Standard は、コールドアーカイブまたはディープコールドアーカイブオブジェクトが Standard 優先度で解凍されることを指定します。

解凍優先度が異なると、データ取得リクエスト料金とデータ取得容量料金も異なります。Expedited の料金が最も高くなります。詳細については、「リクエスト料金」をご参照ください。

--archive-max-days

int

バッチ解凍操作でアーカイブオブジェクトが解凍状態で保持される最大日数。デフォルト値:7。--days がこの値より大きい場合、アーカイブオブジェクトはこの日数分解凍され、他のストレージクラスのオブジェクトは --days で指定された日数分解凍されます。

説明

ossutil restore oss://examplebucket/dir/ -r --days 30 --archive-max-days 7 は、コールドアーカイブおよびディープコールドアーカイブオブジェクトが 30 日間解凍され、アーカイブオブジェクトが 7 日間解凍されることを指定します。

--checkers

int

並行して実行されるチェックタスクの数。デフォルト値:16。

説明

--checkers 32 は、32 個のチェックタスクが並行して実行されることを指定します。

--dirs

/

すべてのサブディレクトリ内のすべてのオブジェクトを再帰的にリストするのではなく、現在のディレクトリ内のオブジェクトとサブディレクトリを返します。

説明

ossutil restore oss://examplebucket/dir/ -d は、dir/ に直接含まれるオブジェクトのみが解凍され、dir/sub/ などのサブディレクトリ内のオブジェクトは解凍されないことを指定します。

--encoding-type

string

指定したオブジェクト名またはファイル名のエンコーディング方式。有効値:url。

説明

ossutil restore "oss://examplebucket/%E6%B5%8B%E8%AF%95.txt" --encoding-type url は、オブジェクト名が URL エンコードされていることを指定します。実際に解凍されるオブジェクトは、名前が %E6%B5%8B%E8%AF%95.txt として URL エンコードされたものです。

--end-with

string

指定された値よりアルファベット順で前にあるオブジェクトを返します (指定された値を含む)。

説明

--end-with dir/c.txt は、名前がアルファベット順で dir/c.txt より前にあるオブジェクトのみが処理されることを指定します (dir/c.txt を含む)。

--exclude

stringArray

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

説明

--exclude "*.csv" は、名前が .csv で終わるオブジェクトが処理されないことを指定します。

--exclude-from

stringArray

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

説明

--exclude-from exclude.txt は、除外ルールが exclude.txt から読み取られることを指定します。このファイルには、*.csv のように 1 行に 1 つのルールが含まれます。

--files-from

stringArray

ファイルからソースオブジェクト名のリストを読み取ります。空行とコメント行は無視されます。

説明

ossutil restore oss://examplebucket/ -r --files-from list.txt は、list.txt にリストされているオブジェクトのみが解凍されることを指定します。ファイルには、dir/a.txt のように 1 行に 1 つのオブジェクト名が含まれます。# または ; で始まる空行とコメント行は無視されます。

--files-from-raw

stringArray

ファイルからソースオブジェクト名のリストを読み取ります。

説明

ossutil restore oss://examplebucket/ -r --files-from-raw list.txt は、list.txt にリストされているオブジェクトのみが解凍されることを指定します。ファイル内の各行はそのままオブジェクト名として使用されます。先頭と末尾のスペースは削除されず、コメント行も無視されません。

--filter

stringArray

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

説明

--filter "+ *.txt" --filter "- *" は、名前が .txt で終わるオブジェクトのみが処理されることを指定します。

--filter-from

stringArray

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

説明

--filter-from rules.txt は、フィルター ルールが rules.txt から読み取られることを指定します。このファイルには、+ *.txt や - * のように 1 行に 1 つのルールが含まれます。

-f, --force

/

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

説明

ossutil restore oss://examplebucket/dir/ -r -f は、dir/ 内のオブジェクトが確認のプロンプトなしで再帰的に解凍されることを指定します。

--include

stringArray

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

説明

--include "*.txt" は、名前が .txt で終わるオブジェクトのみが処理されることを指定します。

--include-from

stringArray

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

説明

--include-from include.txt は、包含ルールが include.txt から読み取られることを指定します。このファイルには、*.txt のように 1 行に 1 つのルールが含まれます。

-j, --job

int

バッチ操作における複数のオブジェクトにまたがる同時実行タスクの数。デフォルト値:3。

説明

-j 10 は、10 個のオブジェクトに対して同時に解凍リクエストが送信されることを指定します。

--limited-num

int

返される結果の最大数。

説明

--limited-num 100 は、最大 100 個のオブジェクトが処理されることを指定します。

--list-objects

/

ListObjects 操作を呼び出してオブジェクトをリストします。

説明

ossutil restore oss://examplebucket/dir/ -r --list-objects は、解凍するオブジェクトがデフォルトの ListObjectsV2 ではなく ListObjects を呼び出すことによってリストされることを指定します。

--min-age

Duration

最終更新時刻がこの値より後のオブジェクトを除外します。デフォルトの単位は秒です。1h のように単位の接尾辞を追加することもできます (1h は 1 時間を示します)。

説明

--min-age 1h は、1 時間以上前に変更されたオブジェクトのみが処理されることを指定します。

--max-age

Duration

最終更新時刻がこの値より前のオブジェクトを除外します。デフォルトの単位は秒です。1h のように単位の接尾辞を追加することもできます (1h は 1 時間を示します)。

説明

--max-age 3d は、過去 3 日以内に変更されたオブジェクトのみが処理されることを指定します。

--min-mtime

Time

最終更新時刻がこの値より前のオブジェクトを除外します。時刻は協定世界時 (UTC) である必要があります。例:2006-01-02T15:04:05。

説明

--min-mtime "2006-01-02T15:04:05" は、2006 年 1 月 2 日 15:04:05 以降に変更されたオブジェクトのみが処理されることを指定します。

--max-mtime

Time

最終更新時刻がこの値より後のオブジェクトを除外します。時刻は協定世界時 (UTC) である必要があります。例:2006-01-02T15:04:05。

説明

--max-mtime "2006-01-02T15:04:05" は、2006 年 1 月 2 日 15:04:05 以前に変更されたオブジェクトのみが処理されることを指定します。

--max-size

SizeSuffix

転送するオブジェクトの最大サイズ。デフォルトの単位はバイトです。B、K、M、G、T、または P の単位接尾辞を追加することもできます。ここで、1K (KiB) = 1024B です。

説明

--max-size 100K は、100 KiB 以下のオブジェクトのみが処理されることを指定します。

--metadata-exclude

stringArray

メタデータがルールに一致するオブジェクトを除外します。メタデータは key=value 形式で照合され、値は * ワイルドカードをサポートします。値なしで key= のみを指定した場合、ルールはどのオブジェクトにも一致しません (解凍されていないオブジェクトを含む)。そのため、この除外ルールを設定しない場合と同じ効果になります。

説明
  1. --metadata-exclude "x-oss-storage-class=DeepColdArchive" は、ディープコールドアーカイブオブジェクトのみが除外されることを指定します。

  2. --metadata-exclude "x-oss-restore=*" は、解凍中のオブジェクトと解凍が完了したオブジェクトが除外されることを指定します。

  3. --metadata-exclude 'x-oss-restore=ongoing-request="false"*' は、解凍が完了したオブジェクトのみが除外されることを指定します。

--metadata-filter

stringArray

オブジェクトのメタデータのフィルター ルール。詳細については、「オブジェクトのメタデータに基づいてオブジェクトをフィルタリングする」をご参照ください。

説明

--metadata-filter "+ x-oss-storage-class=ColdArchive" --metadata-filter "- **" は、コールドアーカイブオブジェクトのみが処理されることを指定します。

--metadata-filter-from

stringArray

ルールファイルからオブジェクトのメタデータフィルター ルールを読み取ります。詳細については、「オブジェクトのメタデータに基づいてオブジェクトをフィルタリングする」をご参照ください。

説明

--metadata-filter-from rules.txt は、メタデータフィルター ルールが rules.txt から読み取られることを指定します。このファイルには、+ x-oss-storage-class=ColdArchive や - ** のように 1 行に 1 つのルールが含まれます。

--metadata-include

stringArray

メタデータがルールに一致するオブジェクトのみを含めます。他のオブジェクトはデフォルトで除外されます。メタデータは key=value 形式で照合され、値は * ワイルドカードをサポートします。

説明
  1. --metadata-include "x-oss-storage-class=ColdArchive" は、コールドアーカイブオブジェクトのみが処理されることを指定します。

  2. --metadata-include "x-oss-storage-class=*Archive" は、アーカイブ、コールドアーカイブ、ディープコールドアーカイブのオブジェクトのみが処理されることを指定します。

--min-size

SizeSuffix

転送するオブジェクトの最小サイズ。デフォルトの単位はバイトです。B、K、M、G、T、または P の単位接尾辞を追加することもできます。ここで、1K (KiB) = 1024B です。

説明

--min-size 100K は、100 KiB 以上のオブジェクトのみが処理されることを指定します。

--no-check-status

/

list:// リストモードでのみ有効です。オブジェクトのステータスチェックをスキップし、リスト内のすべてのオブジェクトに対して直接解凍リクエストを送信します。このパラメーターが指定されていない場合、リストモードは再帰モードと同じように動作します。解凍中のオブジェクトと、ストレージクラスがアーカイブ、コールドアーカイブ、またはディープコールドアーカイブでないオブジェクトはスキップされますが、解凍が完了したオブジェクトに対しては再度解凍リクエストを送信します。このパラメーターが指定されている場合、解凍中のオブジェクトは RestoreAlreadyInProgress エラーを返し、ストレージクラスがアーカイブ、コールドアーカイブ、またはディープコールドアーカイブでないオブジェクトは OperationNotSupported エラーを返します。このパラメーターは再帰モードでは効果がありません。

説明

ossutil restore list://list.txt --no-check-status は、list.txt 内のすべてのオブジェクトに対してステータスをチェックせずに解凍リクエストを送信することを指定します。コマンドを実行する前にリストの範囲を確認してください。

--no-error-report

/

バッチ操作中にエラーレポートファイルを生成しません。

説明

ossutil restore oss://examplebucket/dir/ -r --no-error-report は、一部のオブジェクトの解凍に失敗した場合でも、再帰的な解凍操作中にエラーレポートファイルが生成されないことを指定します。

--no-progress

/

進捗状況を表示しません。

説明

ossutil restore oss://examplebucket/dir/ -r --no-progress は、再帰的な解凍操作中に進捗が表示されないことを指定します。

--output-dir

string

バッチ操作中に生成されるエラーレポートファイルの出力ディレクトリ。デフォルト値:ossutil_output。

説明

--output-dir ./restore_report は、エラーレポートファイルが restore_report ディレクトリに生成されることを指定します。

--page-size

int

バッチ操作でオブジェクトがリストされるときに、ページごとに返されるオブジェクトの最大数。デフォルト値:1000。有効値:1~1000。

説明

--page-size 100 は、オブジェクトがリストされるときにページごとに最大 100 個のオブジェクトが返されることを指定します。

-r, --recursive

/

操作を再帰的に実行します。このオプションが指定されている場合、コマンドはバケット内の一致するすべてのオブジェクトに対して操作を実行します。それ以外の場合、コマンドはパスで指定されたオブジェクトに対してのみ操作を実行します。

説明

ossutil restore oss://examplebucket/dir/ -r は、dir/ およびそのサブディレクトリ内の一致するすべてのオブジェクトが解凍されることを指定します。-r が指定されていない場合、dir/ は単一のオブジェクトの名前として扱われます。

--request-payer

string

リクエストの支払者。リクエスト元支払いモードが使用されている場合にこの値を設定します。有効値:requester。

説明

--request-payer requester は、この解凍リクエストによって発生した料金をリクエスト元が支払うことを指定します。

--start-after

string

指定された値よりアルファベット順で後にあるオブジェクトを返します (指定された値を除く)。

説明

--start-after dir/c.txt は、名前がアルファベット順で dir/c.txt より後にあるオブジェクトのみが処理されることを指定します (dir/c.txt を除く)。

--support-dir-object

/

--files-from を使用する場合など、ファイルからオブジェクトリストを読み取るときに、名前が / で終わるディレクトリオブジェクトを通常のオブジェクトとして扱います。

説明

ossutil restore oss://examplebucket/ -r --files-from list.txt --support-dir-object は、list.txt 内の dir/folder/ のように / で終わるエントリがディレクトリオブジェクト自体として解凍されることを指定します。このパラメーターが指定されていない場合、そのようなエントリはどのオブジェクトにも一致しません。

--version-id

string

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

説明

ossutil restore oss://examplebucket/exampleobject.txt --version-id CAEQNhiBgMDJgZCA0BYiIDc4MGZjZGI2OTBjOTRmNTE5NmU5NmFhZjhjYmY0**** は、exampleobject.txt の指定されたバージョンが解凍されることを指定します。

--list-format

string

リストファイルのフォーマット。有効値:plain および inventory。

説明

--list-format inventory は、リストファイルがインベントリ結果ファイルであることを指定します。この場合、--list-manifest-from も指定する必要があります。

--list-manifest-from

string

ファイルからリストファイルのフォーマット記述を読み取ります。リストファイルのフォーマットが inventory の場合は、このパラメーターを設定する必要があります。

説明

--list-format inventory --list-manifest-from manifest.json は、リストファイルのフォーマット記述がインベントリ結果の manifest.json から読み取られることを指定します。

説明

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

例

アーカイブオブジェクトの復元

  • 次の例では、宛先バケット examplebucket 内のアーカイブオブジェクト exampleobject.txt を解凍します。

    ossutil restore oss://examplebucket/exampleobject.txt
  • 次の例では、宛先バケット examplebucket 内のアーカイブオブジェクト exampleobject.txt を解凍し、オブジェクトを 3 日間解凍状態に保ちます。

    ossutil restore oss://examplebucket/exampleobject.txt --days 3
  • 次の例では、リストからオブジェクトを解凍します。

    説明

    リストファイルの各行は 1 つのオブジェクトを表し、OSS パス形式 `oss://{bucket}/{key}` を使用します。次の list.txt ファイルは一例です。

    oss://examplebucket/key1
    oss://examplebucket/key2
    ossutil restore list://list.txt
  • 次の例では、リストモードを使用して、list.txt 内のオブジェクトのステータスをチェックせずに直接解凍リクエストを送信します。リスト内で解凍中のオブジェクトは RestoreAlreadyInProgress エラーを返し、ストレージクラスがアーカイブ、コールドアーカイブ、またはディープコールドアーカイブでないオブジェクトは OperationNotSupported エラーを返します。

    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

次の例では、宛先バケット examplebucket の dir ディレクトリ内にあるすべてのコールドアーカイブ .csv オブジェクトを再帰的に解凍し、オブジェクトを 5 日間解凍状態に保ちます。

ossutil restore oss://examplebucket/dir/ -r --include "*.csv" --metadata-include "x-oss-storage-class=ColdArchive" --tier Bulk --days 5

次の例では、dir ディレクトリ内のコールドアーカイブオブジェクトを再帰的に選択し、解凍が完了したオブジェクトを明示的に除外します。ongoing-request="false" の値は完了した解凍を示し、末尾の * は変動する有効期限に一致します。除外ルールを包含ルールの前に配置してください。バッチ解凍操作のデフォルトのステータスチェックでは、まだ解凍中のオブジェクトはスキップされます。

ossutil restore oss://examplebucket/dir/ -r --tier Standard --days 365 --metadata-exclude 'x-oss-restore=ongoing-request="false"*' --metadata-include "x-oss-storage-class=ColdArchive"

解凍中のオブジェクトと解凍が完了したオブジェクトの両方を除外するには、代わりに x-oss-restore=* を使用します。x-oss-restore= はどのオブジェクトにも一致しないため、除外ルールは効果がありません。

ossutil restore oss://examplebucket/dir/ -r --tier Standard --days 365 --metadata-exclude "x-oss-restore=*" --metadata-include "x-oss-storage-class=ColdArchive"

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

次の例では、宛先バケット examplebucket 内のディープコールドアーカイブオブジェクト exampleobject.txt を解凍し、オブジェクトを 10 日間解凍状態に保ちます。

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

次の例では、宛先バケット examplebucket の dir ディレクトリ内にあるすべてのディープコールドアーカイブ .csv オブジェクトを再帰的に解凍し、オブジェクトを 10 日間解凍状態に保ちます。

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

課金

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

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

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

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

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

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

  • 解凍状態が終了すると、オブジェクトは凍結状態に戻ります。オブジェクトを再度解凍すると、データ取得料金が発生します。