直接読み取りが有効になっていない場合、アーカイブストレージのオブジェクトは読み取り前に解凍する必要があります。コールドアーカイブストレージおよびディープコールドアーカイブストレージのストレージクラスでは直接読み取りがサポートされていません。したがって、これらのストレージクラスに格納されたオブジェクトは、読み取り前に必ず解凍する必要があります。アーカイブストレージのオブジェクトの解凍には通常数分、コールドアーカイブストレージのオブジェクトの解凍には通常数時間、ディープコールドアーカイブストレージのオブジェクトの解凍には通常 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 分かかるため)。
異なるストレージクラスのオブジェクトをバッチで解凍する場合、指定した優先度が特定のクラスでサポートされていない場合は、自動的にそのクラスでサポートされる最低の優先度に調整されます。たとえば、コールドアーカイブストレージでは 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 時間の場合は 説明
|
|
--max-age |
Duration |
指定された値より古いオブジェクトを除外します。デフォルトの単位は秒です。単位接尾辞(例:1 時間の場合は |
|
--min-mtime |
Time |
指定された時刻より前に変更されたオブジェクトを除外します。時刻は協定世界時 (UTC) 形式で指定する必要があります(例:2006-01-02T15:04:05)。 説明
|
|
--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 モードのバケットでは、 |
|
--start-after |
string |
アルファベット順で指定された値より後(その値を含まない)のオブジェクトを一覧表示します。 |
|
--version-id |
string |
オブジェクトのバージョン ID。 |
|
--list-format |
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}で 1 つのオブジェクトが指定されます。たとえば、list.txtファイルの内容は以下のとおりです。oss://examplebucket/key1 oss://examplebucket/key2ossutil 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 の dir/ プレフィックス配下にあるすべてのコールドアーカイブストレージの .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
次のコマンドは、バケット examplebucket の dir/ プレフィックス配下にあるすべてのディープコールドアーカイブストレージの .csv オブジェクトを再帰的に解凍します。解凍期間は 10 日間に設定されます。
ossutil restore oss://examplebucket/dir/ -r --include "*.csv" --tier Standard --days 10
課金
-
アーカイブ、コールドアーカイブストレージ、およびディープコールドアーカイブストレージのオブジェクトを解凍すると、データ取得料金が発生します。詳細については、「データ処理料金」をご参照ください。
-
アーカイブストレージのオブジェクトは、解凍状態を最大 7 日間維持できます。コールドアーカイブストレージおよびディープコールドアーカイブストレージのオブジェクトは、解凍状態を最大 365 日間維持できます。この期間中は、追加のデータ取得料金は発生しません。
-
解凍状態の有効期限が切れた後、オブジェクトは凍結ステータスに戻ります。再度オブジェクトを解凍する場合、データ取得料金が発生します。
-
コールドアーカイブまたはディープコールドアーカイブのオブジェクトを解凍すると、アクセスを可能にするために、そのオブジェクトのレプリカが標準ストレージクラスに作成されます。オブジェクトが解凍状態にある間は、このレプリカの一時的なストレージに対して、標準ストレージクラスの料金で課金されます。詳細については、「一時的なストレージ料金」をご参照ください。