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

Object Storage Service:復元

最終更新日:Dec 05, 2024

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

使用上の注意

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

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

コマンド構文

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

パラメーター

タイプ

説明

-- 日

int

オブジェクトが復元された状態のままである期間。 単位:日 有効な値: 1 ~ 365

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

-- 層

String

復元の優先順位。 Archiveオブジェクトにこのパラメーターを指定する必要はありません。 修復には約1分かかります。

  • コールドアーカイブ:

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

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

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

  • 深い冷たいアーカイブ:

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

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

異なるストレージクラス内の複数のオブジェクトに対して一度に操作を実行する場合、-- tierパラメーターの値がストレージクラスでサポートされている優先度の値を超えると、その値は自動的にストレージクラスの最も低い優先度に設定されます。 たとえば、Cold ArchiveオブジェクトはBulkをサポートしますが、Deep Cold ArchiveオブジェクトはStandardのみをサポートします。 この場合、-- tierパラメーターをBulkに設定すると、復元の優先順位は自動的にStandardに調整されます。

-- dirs

/

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

-- encoding-type

String

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

-- end-with

String

-- end-withパラメーターの値の前または同じ名前のオブジェクトが返されるように指定します。

-除外

stringArray

パスまたはオブジェクト名の除外ルールを指定します。

-- exclude-from

stringArray

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

-- files-から

stringArray

空行またはコメント行を無視して、ファイルからオブジェクト名を読み取ります。

-- files-from-raw

stringArray

空の行とコメント行を無視せずに、ファイルからオブジェクト名を読み取ります。

-- フィルター

stringArray

パスまたはオブジェクト名のフィルタールールを指定します。

-- filter-from

stringArray

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

-f、-- 力

/

確認を必要とせずに操作を強制します。

-含む

stringArray

パスまたはオブジェクト名の包含ルールを指定します。

-- include-from

stringArray

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

-- 限られたnum

int

返される結果の最大数。

-- list-objects

/

ListObjects操作を呼び出してオブジェクトを一覧表示します。

-最大年齢

有効期間

最終変更時刻がこのパラメーターの値より前のオブジェクトを除外します。 デフォルトの単位はs (秒) です。 ミリ秒はms、秒はs、分はm、時間はh、日はd、週はw、月はM、年はyの単位で数値をサフィックスできます。

-- max-mtime

時間

最終変更時刻がこのパラメーターの値より後のオブジェクトを除外します。 時刻は UTC である必要があります。

-最大サイズ

SizeSuffix

転送できるオブジェクトの最大サイズ。 デフォルトでは、サイズはバイト (B) 単位です。 数値に1024ベースの単位 (Bはbyte、KはKibibyte、MはMebibyte、GはGibibyte、TはTebibyte、PはPebibyte) でサフィックスを付けることができます。

-- metadata-除外

stringArray

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

-- metadata-filter

stringArray

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

-- metadata-filter-from

stringArray

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

-- metadata-include

stringArray

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

-- 最低年齢

有効期間

最終変更時刻がこのパラメーターの値より後のオブジェクトを除外します。 デフォルトの単位はs (秒) です。 ミリ秒はms、秒はs、分はm、時間はh、日はd、週はw、月はM、年はyの単位で数値をサフィックスできます。

-- min-mtime

時間

最終変更時刻がこのパラメーターの値より前のオブジェクトを除外します。 時刻は UTC である必要があります。

-- 最小サイズ

SizeSuffix

転送できるファイルとオブジェクトの最小サイズ。 デフォルトでは、サイズはバイト (B) 単位です。 数値に1024ベースの単位 (Bはbyte、KはKibibyte、MはMebibyte、GはGibibyte、TはTebibyte、PはPebibyte) でサフィックスを付けることができます。

-- ページサイズ

int

1ページあたりに返すオブジェクトの最大数。 有効な値: 1 ~ 1000 デフォルト値は 1000 です。

-r, -- recursive

/

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

-- request-payer

String

リクエストの支払人。 pay-by-requesterが有効な場合は、このパラメーターを指定します。 有効値: requester。

-- start-after

String

-- end-withパラメーターの値の前または同じ名前のオブジェクトが返されるように指定します。

-- version-id

String

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

-- リスト形式

String

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

-- list-manifest-from

String

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

説明

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

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

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

Cold Archiveオブジェクトを復元する

次のサンプルコードは、examplebucketでexampleobject.txtという名前のCold Archiveオブジェクトを復元し、オブジェクトが復元された状態のままである期間を5に設定する方法の例を示しています。

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

Deep Cold Archiveオブジェクトを復元する

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

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

課金ルール

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

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

  • Cold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトを復元すると、データ取得要求が課金されます。 詳細については、「API 操作呼び出し料金」をご参照ください。

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

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

  • アーカイブオブジェクトは、最大7日間復元された状態を維持できます。 Cold ArchiveオブジェクトまたはDeep Cold Archiveオブジェクトは、最大365日間復元された状態を維持できます。 オブジェクトが復元された状態の場合、データ取得料金は請求されません。

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