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

Object Storage Service:復元

最終更新日:Jun 18, 2025

アーカイブオブジェクトのリアルタイムアクセスを有効にしていない場合、アーカイブオブジェクトは復元後にのみアクセスできます。 コールドアーカイブオブジェクトとディープコールドアーカイブオブジェクトでは、アーカイブオブジェクトのリアルタイムアクセスはサポートされていません。 コールドアーカイブオブジェクトとディープコールドアーカイブオブジェクトは、復元後にのみアクセスできます。 ほとんどの場合、アーカイブオブジェクトの復元には数分かかり、コールドアーカイブオブジェクトの復元には数時間かかり、ディープコールドアーカイブオブジェクトの復元には 12 ~ 48 時間かかります。 前述の復元時間は参考値です。 実際のシナリオによって復元時間は異なる場合があります。 このトピックでは、restore コマンドを実行してオブジェクトを復元する方法について説明します。

使用上の注意

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

  • 復元プロセスと請求ルールの詳細については、「オブジェクトの復元」をご参照ください。

コマンド構文

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

パラメーター

タイプ

説明

--days

int

オブジェクトが復元された状態を維持する期間。 単位:日。 有効な値:1 ~ 365。

ストレージクラスが異なる複数のオブジェクトに対して同時に操作を実行する場合、--days パラメーターの値が特定のストレージクラスの最大期間を超えると、値は自動的にそのストレージクラスの最大期間に設定されます。 たとえば、アーカイブでサポートされる最大期間は 7 日、ディープコールドアーカイブでサポートされる最大期間は 365 日です。 --days パラメーターを 100 に設定すると、アーカイブオブジェクトの期間は自動的に 7 日に設定され、ディープコールドアーカイブオブジェクトの期間は自動的に 100 日に設定されます。

--tier

string

復元の優先度。 アーカイブオブジェクトの場合は、このパラメーターを指定する必要はありません。 復元には約 1 分かかります。

  • コールドアーカイブ:

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

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

    • 一括: オブジェクトは 5 ~ 12 時間以内に復元されます。

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

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

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

ストレージクラスが異なる複数のオブジェクトに対して同時に操作を実行する場合、--tier パラメーターの値がストレージクラスでサポートされている優先度の値を超えると、値は自動的にそのストレージクラスの最低優先度に設定されます。 たとえば、コールドアーカイブオブジェクトは一括をサポートしますが、ディープコールドアーカイブオブジェクトは標準のみをサポートします。 この場合、--tier パラメーターを一括に設定すると、復元の優先度は自動的に標準に調整されます。

--dirs

/

すべてのサブディレクトリのすべてのオブジェクトを再帰的に表示する代わりに、現在のディレクトリのオブジェクトとサブディレクトリを一覧表示します。

--encoding-type

string

オブジェクト名のエンコードに使用されるエンコード方式。 有効な値:url。

--end-with

string

名前がアルファベット順で --end-with パラメーターの値と同じかそれ以前のオブジェクトを返します。

--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

最終更新時刻がこのオプションの値より遅いオブジェクトを除外します。 デフォルトの単位は s(秒)です。 数値の後に時間の単位を付けることができます。 たとえば、1h は 1 時間を示します。

説明

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

--max-age

Duration

最終更新時刻がこのオプションの値より早いオブジェクトを除外します。 デフォルトの単位は s(秒)です。 数値の後に時間の単位を付けることができます。 たとえば、1h は 1 時間を示します。

--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-size

SizeSuffix

転送できるオブジェクトの最大サイズ。 デフォルトでは、サイズはバイト(B)単位です。 数値の後に 1024 ベースの単位を付けることができます。B はバイト、K はキロバイト、M はメガバイト、G はギガバイト、T はテラバイト、P はペタバイトです。

--metadata-exclude

stringArray

オブジェクトメタデータの除外ルールを指定します。

--metadata-filter

stringArray

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

--metadata-filter-from

stringArray

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

--metadata-include

stringArray

オブジェクトメタデータの包含ルールを指定します。

--min-size

SizeSuffix

転送できるファイルとオブジェクトの最小サイズ。 デフォルトでは、サイズはバイト(B)単位です。 数値の後に 1024 ベースの単位を付けることができます。B はバイト、K はキロバイト、M はメガバイト、G はギガバイト、T はテラバイト、P はペタバイトです。

--page-size

int

バッチモードでページ分割リストを実行するときに、ページごとに返すことができるオブジェクトの最大数。 有効な値:1 ~ 1000。 デフォルト値:1000。

-r, --recursive

/

コマンドが操作を再帰的に実行することを指定します。 このパラメーターを指定すると、コマンドはバケット内のすべての一致するオブジェクトに対して操作を実行します。 このパラメーターを指定しないと、コマンドは指定されたパスの指定されたオブジェクトに対してのみ操作を実行します。

--request-payer

string

リクエストの支払者。 リクエスト者による支払いが有効になっている場合は、このパラメーターを指定します。 有効な値:requester。

--start-after

string

名前がアルファベット順で --end-with パラメーターの値と同じかそれ以前のオブジェクトを返します。

--version-id

string

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

--list-format

string

リストファイルの形式。 有効な値:plain と inventory。

--list-manifest-from

string

ファイルからリストファイルの形式の説明を読み取ります。 形式が inventory の場合は、このパラメーターを指定する必要があります。

説明

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

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

  • 次のサンプルコードは、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})です。

    次のセクションでは、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

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

次のサンプルコードは、examplebucket 内の exampleobject.txt という名前のディープコールドアーカイブオブジェクトを復元し、オブジェクトが復元された状態を維持する期間を 10 に設定する方法の例を示しています。

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

請求ルール

  • リストアされたアーカイブ、コールドアーカイブ、またはディープコールドアーカイブオブジェクトのサイズに基づいてデータ取得料金が請求されます。 詳細については、「データ処理料金」をご参照ください。

  • アーカイブオブジェクトを復元すると、PUT リクエストの数に基づいて API 操作呼び出し料金が課金されます。詳細については、「API 操作呼び出し料金」をご参照ください。

  • コールドアーカイブまたはディープコールドアーカイブオブジェクトを復元すると、データ検索リクエストに対して課金されます。詳細については、「API 操作呼び出し料金」をご参照ください。

  • リストア中およびリストア後、アーカイブ、コールドアーカイブ、およびディープコールドアーカイブオブジェクトの請求ルールに基づいてストレージ料金が発生します。詳細については、「ストレージ料金」をご参照ください。

  • コールドアーカイブまたはディープコールドアーカイブオブジェクトをリストアすると、一時的なアクセス用にオブジェクトの標準レプリカが生成されます。 コールドアーカイブまたはディープコールドアーカイブオブジェクトが凍結状態に戻るまで、標準ストレージクラスに基づいてレプリカの一時ストレージ料金が請求されます。 詳細については、「一時ストレージ料金」をご参照ください。

  • アーカイブオブジェクトは、最大 7 日間リストアされた状態のままにすることができます。 コールドアーカイブまたはディープコールドアーカイブオブジェクトは、最大 365 日間リストアされた状態のままにすることができます。 オブジェクトがリストアされた状態の間は、データ取得料金は請求されません。

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