POST Object restore

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

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

StorageGRIDでオブジェクトのリストアに使用できる要求はPOST Object restoreのみです。SELECTタイプのリストアはサポートされません。SELECT要求を使用するとXNotImplementedが返されます。

バージョン管理

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

クラウド ストレージ プール オブジェクトに対するPOST Object restoreの動作

オブジェクトがクラウド ストレージ プールに格納されている場合(StorageGRIDの管理手順を参照)、POST Object restore要求はオブジェクトの状態に基づいて次のように動作します。詳細については、「HEAD Object」を参照してください。

注:オブジェクトがクラウド ストレージ プールに格納され、かつそのオブジェクトのコピーがグリッドに1つ以上存在する場合は、POST Object restore要求を実行してオブジェクトをリストアする必要はありません。GET Object要求を使用してローカル コピーを直接読み出すことができます。
オブジェクトの状態 POST Object restoreの動作

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

403 Forbidden, InvalidObjectState

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

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

読み出し不可能な状態に移行済み

202 Accepted

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

リストア ジョブの所要時間(ExpeditedStandard、またはBulk)を指定する場合は、Tier要求要素を使用します。Tierを指定しない場合、Standard階層が使用されます。

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

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

409 Conflict, RestoreAlreadyInProgress

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

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