RestoreObject

02/14/2024 貢獻者

您可以使用 S3 RestoreObject 要求來還原儲存在雲端儲存池中的物件。

支援的要求類型

StorageGRID 僅支援還原物件的 RestoreObject 要求。它不支援 SELECT 還原類型。選取「要求傳回」 XNotImplemented。

或者、請指定 versionId 還原版本化儲存區中物件的特定版本。如果您沒有指定 versionId，則會還原物件的最新版本

如果物件已儲存在中 "雲端儲存資源池"， RestoreObject 要求會根據物件的狀態而有下列行為。請參閱 "標題物件" 以取得更多詳細資料。

如果物件儲存在雲端儲存池中、且網格上也有一個或多個物件複本、則無需透過發出 RestoreObject 要求來還原物件。而是可以使用 GetObject 要求直接擷取本機複本。

物件狀態 RestoreObject 的行為

物件狀態	RestoreObject 的行為
物件擷取至StorageGRID 不受ILM評估、或物件不在雲端儲存資源池中	`403 Forbidden`、 `InvalidObjectState`
Cloud Storage Pool中的物件、但尚未轉換為無法擷取的狀態	`200 OK` 不會進行任何變更。注意 * ：在物件轉換為不可擷取的狀態之前、您無法變更物件 `expiry-date`。
物件移轉至無法擷取的狀態	`202 Accepted` 將物件的可擷取複本還原至Cloud Storage Pool、直到要求本文指定的天數。在此期間結束時、物件會返回無法擷取的狀態。您也可以選擇使用 `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`。還原日期會根據申請時間而更新。

物件擷取至StorageGRID 不受ILM評估、或物件不在雲端儲存資源池中

403 Forbidden、 InvalidObjectState

Cloud Storage Pool中的物件、但尚未轉換為無法擷取的狀態

200 OK 不會進行任何變更。

物件移轉至無法擷取的狀態

202 Accepted 將物件的可擷取複本還原至Cloud Storage Pool、直到要求本文指定的天數。在此期間結束時、物件會返回無法擷取的狀態。

您也可以選擇使用 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。還原日期會根據申請時間而更新。