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分かかります。
異なるストレージクラス内の複数のオブジェクトに対して一度に操作を実行する場合、-- 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日間復元された状態を維持できます。 オブジェクトが復元された状態の場合、データ取得料金は請求されません。
オブジェクトが復元状態にある期間が終了すると、オブジェクトは凍結状態に戻る。 凍結状態に戻った後にオブジェクトを復元すると、データ取得料金が発生します。