アーカイブオブジェクトのリアルタイムアクセスが有効になっていない場合、アーカイブオブジェクトは解凍後にのみ読み取り可能です。コールドアーカイブまたはディープコールドアーカイブのオブジェクトはリアルタイムアクセスをサポートしていないため、これらのオブジェクトは解凍後にのみ読み取り可能です。アーカイブオブジェクトの解凍には通常数分、コールドアーカイブオブジェクトの解凍には通常数時間、ディープコールドアーカイブオブジェクトの解凍には通常 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 が使用されます。 説明
|
|
--tier |
string |
解凍優先度。アーカイブオブジェクトは 1 分で解凍されるため、このパラメーターを指定する必要はありません。
混合ストレージクラスのオブジェクトに対してバッチ操作を実行する場合、--tier の値がストレージクラスでサポートされている優先度を超えると、その値はそのストレージクラスでサポートされている最も低い優先度に自動的に調整されます。たとえば、コールドアーカイブは Bulk をサポートし、ディープコールドアーカイブは Standard のみをサポートします。--tier を Bulk に設定した場合、ディープコールドアーカイブオブジェクトの値は自動的に Standard に調整されます。 説明
解凍優先度が異なると、データ取得リクエスト料金とデータ取得容量料金も異なります。Expedited の料金が最も高くなります。詳細については、「リクエスト料金」をご参照ください。 |
|
--archive-max-days |
int |
バッチ解凍操作でアーカイブオブジェクトが解凍状態で保持される最大日数。デフォルト値:7。--days がこの値より大きい場合、アーカイブオブジェクトはこの日数分解凍され、他のストレージクラスのオブジェクトは --days で指定された日数分解凍されます。 説明
|
|
--checkers |
int |
並行して実行されるチェックタスクの数。デフォルト値:16。 説明
|
|
--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 |
ルールファイルから包含ルールを読み取ります。 説明
|
|
-j, --job |
int |
バッチ操作における複数のオブジェクトにまたがる同時実行タスクの数。デフォルト値:3。 説明
|
|
--limited-num |
int |
返される結果の最大数。 説明
|
|
--list-objects |
/ |
ListObjects 操作を呼び出してオブジェクトをリストします。 説明
|
|
--min-age |
Duration |
最終更新時刻がこの値より後のオブジェクトを除外します。デフォルトの単位は秒です。1h のように単位の接尾辞を追加することもできます (1h は 1 時間を示します)。 説明
|
|
--max-age |
Duration |
最終更新時刻がこの値より前のオブジェクトを除外します。デフォルトの単位は秒です。1h のように単位の接尾辞を追加することもできます (1h は 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 の単位接尾辞を追加することもできます。ここで、1K (KiB) = 1024B です。 説明
|
|
--metadata-exclude |
stringArray |
メタデータがルールに一致するオブジェクトを除外します。メタデータは 説明
|
|
--metadata-filter |
stringArray |
オブジェクトのメタデータのフィルター ルール。詳細については、「オブジェクトのメタデータに基づいてオブジェクトをフィルタリングする」をご参照ください。 説明
|
|
--metadata-filter-from |
stringArray |
ルールファイルからオブジェクトのメタデータフィルター ルールを読み取ります。詳細については、「オブジェクトのメタデータに基づいてオブジェクトをフィルタリングする」をご参照ください。 説明
|
|
--metadata-include |
stringArray |
メタデータがルールに一致するオブジェクトのみを含めます。他のオブジェクトはデフォルトで除外されます。メタデータは 説明
|
|
--min-size |
SizeSuffix |
転送するオブジェクトの最小サイズ。デフォルトの単位はバイトです。B、K、M、G、T、または P の単位接尾辞を追加することもできます。ここで、1K (KiB) = 1024B です。 説明
|
|
--no-check-status |
/ |
説明
|
|
--no-error-report |
/ |
バッチ操作中にエラーレポートファイルを生成しません。 説明
|
|
--no-progress |
/ |
進捗状況を表示しません。 説明
|
|
--output-dir |
string |
バッチ操作中に生成されるエラーレポートファイルの出力ディレクトリ。デフォルト値:ossutil_output。 説明
|
|
--page-size |
int |
バッチ操作でオブジェクトがリストされるときに、ページごとに返されるオブジェクトの最大数。デフォルト値:1000。有効値:1~1000。 説明
|
|
-r, --recursive |
/ |
操作を再帰的に実行します。このオプションが指定されている場合、コマンドはバケット内の一致するすべてのオブジェクトに対して操作を実行します。それ以外の場合、コマンドはパスで指定されたオブジェクトに対してのみ操作を実行します。 説明
|
|
--request-payer |
string |
リクエストの支払者。リクエスト元支払いモードが使用されている場合にこの値を設定します。有効値:requester。 説明
|
|
--start-after |
string |
指定された値よりアルファベット順で後にあるオブジェクトを返します (指定された値を除く)。 説明
|
|
--support-dir-object |
/ |
--files-from を使用する場合など、ファイルからオブジェクトリストを読み取るときに、名前が / で終わるディレクトリオブジェクトを通常のオブジェクトとして扱います。 説明
|
|
--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 -
次の例では、リストからオブジェクトを解凍します。
説明リストファイルの各行は 1 つのオブジェクトを表し、OSS パス形式 `oss://{bucket}/{key}` を使用します。次の list.txt ファイルは一例です。
oss://examplebucket/key1 oss://examplebucket/key2ossutil 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 日間、解凍状態を維持できます。この期間中、追加のデータ取得料金は発生しません。
解凍状態が終了すると、オブジェクトは凍結状態に戻ります。オブジェクトを再度解凍すると、データ取得料金が発生します。