Skip to main content
本製品の最新リリースがご利用いただけます。
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

RestoreObject

共同作成者
PDF

S3 RestoreObject要求を使用して、クラウドストレージプールに格納されているオブジェクトをリストアできます。

サポートされている要求タイプ

StorageGRIDでは、オブジェクトのリストアでRestoreObject要求のみがサポートされます。ではサポートされません SELECT リストアのタイプ。戻り要求を選択してください XNotImplemented。

バージョン管理

必要に応じて、と指定します versionId バージョン管理されたバケット内のオブジェクトの特定のバージョンをリストアする。指定しない場合 `versionId`オブジェクトの最新バージョンがリストアされます

クラウドストレージプールオブジェクトでのRestoreObjectの動作

オブジェクトがに格納されている場合 "クラウドストレージプール"のRestoreObject要求の動作は、オブジェクトの状態に基づいて次のようになります。を参照してください "HeadObject （ヘッドオブジェクト）" 詳細：

メモ オブジェクトがクラウドストレージプールに格納されていて、そのオブジェクトのコピーがグリッドに1つ以上存在する場合は、RestoreObject要求を実行してオブジェクトをリストアする必要はありません。代わりに、GetObject要求を使用してローカルコピーを直接取得できます。
オブジェクトの状態 RestoreObjectの動作

StorageGRID に取り込まれているがまだ ILM によって評価されていない、またはオブジェクトがクラウドストレージプールにない

403 Forbidden、 InvalidObjectState

クラウドストレージプール内にあるが、まだ読み出し不可能な状態に移行していない

200 OK 変更は行われません。

注：オブジェクトが読み出し不可能な状態に移行されるまでは変更できません expiry-date。

オブジェクトを読み出し不可能な状態に移行した

202 Accepted 要求の本文で指定されている日数、オブジェクトの読み出し可能なコピーをクラウドストレージプールにリストアします。この期間が終了すると、オブジェクトは読み出し不可能な状態に戻ります。

必要に応じて、を使用します Tier リストアジョブの完了までにかかる時間を確認するための要求要素 (Expedited、 Standard`または `Bulk）。指定しない場合 Tier、 Standard 階層を使用しています。

重要：オブジェクトがS3 Glacier Deep Archiveに移行された場合、またはクラウドストレージプールがAzure BLOBストレージを使用している場合は、を使用してリストアできません Expedited 階層：次のエラーが返されます 403 Forbidden、 InvalidTier： Retrieval option is not supported by this storage class。

読み出し不可能な状態からリストア中である

409 Conflict、 RestoreAlreadyInProgress

クラウドストレージプールへのリストアが完了している

200 OK

*注：*オブジェクトが読み出し可能な状態にリストアされている場合は、オブジェクトを変更できます expiry-date 新しい値を指定してRestoreObject要求を再発行する Days。要求が実行された日時に基づいてリストア日が更新されます。