Skip to main content
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

RestoreObject

共同作成者
PDF

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

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

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

バージョン管理

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

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

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

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

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

403 Forbidden、 InvalidObjectState

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

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

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

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

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

必要に応じて、request要素を使用し 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

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