アーカイブオブジェクトのリアルタイムアクセスを有効にしていない場合、アーカイブオブジェクトは復元後にのみアクセスできます。 コールドアーカイブオブジェクトとディープコールドアーカイブオブジェクトでは、アーカイブオブジェクトのリアルタイムアクセスはサポートされていません。 コールドアーカイブオブジェクトとディープコールドアーカイブオブジェクトは、復元後にのみアクセスできます。 ほとんどの場合、アーカイブオブジェクトの復元には数分かかり、コールドアーカイブオブジェクトの復元には数時間かかり、ディープコールドアーカイブオブジェクトの復元には 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 分かかります。
ストレージクラスが異なる複数のオブジェクトに対して同時に操作を実行する場合、--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 時間を示します。 説明
|
--max-age | Duration | 最終更新時刻がこのオプションの値より早いオブジェクトを除外します。 デフォルトの単位は s(秒)です。 数値の後に時間の単位を付けることができます。 たとえば、1h は 1 時間を示します。 |
--min-mtime | Time | 最終更新時刻がこのオプションの値より早いオブジェクトを除外します。 時刻は UTC でなければなりません。 例:2006-01-02T15: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/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 内の exampleobject.txt という名前のディープコールドアーカイブオブジェクトを復元し、オブジェクトが復元された状態を維持する期間を 10 に設定する方法の例を示しています。
ossutil restore oss://examplebucket/exampleobject.txt --tier Standard --days 10請求ルール
リストアされたアーカイブ、コールドアーカイブ、またはディープコールドアーカイブオブジェクトのサイズに基づいてデータ取得料金が請求されます。 詳細については、「データ処理料金」をご参照ください。
アーカイブオブジェクトを復元すると、PUT リクエストの数に基づいて API 操作呼び出し料金が課金されます。詳細については、「API 操作呼び出し料金」をご参照ください。
コールドアーカイブまたはディープコールドアーカイブオブジェクトを復元すると、データ検索リクエストに対して課金されます。詳細については、「API 操作呼び出し料金」をご参照ください。
リストア中およびリストア後、アーカイブ、コールドアーカイブ、およびディープコールドアーカイブオブジェクトの請求ルールに基づいてストレージ料金が発生します。詳細については、「ストレージ料金」をご参照ください。
コールドアーカイブまたはディープコールドアーカイブオブジェクトをリストアすると、一時的なアクセス用にオブジェクトの標準レプリカが生成されます。 コールドアーカイブまたはディープコールドアーカイブオブジェクトが凍結状態に戻るまで、標準ストレージクラスに基づいてレプリカの一時ストレージ料金が請求されます。 詳細については、「一時ストレージ料金」をご参照ください。
アーカイブオブジェクトは、最大 7 日間リストアされた状態のままにすることができます。 コールドアーカイブまたはディープコールドアーカイブオブジェクトは、最大 365 日間リストアされた状態のままにすることができます。 オブジェクトがリストアされた状態の間は、データ取得料金は請求されません。
オブジェクトがリストアされた状態の期間が終了すると、オブジェクトは凍結状態に戻ります。 凍結状態に戻った後にオブジェクトをリストアすると、データ取得料金が請求されます。