RestoreObject
You can use the S3 RestoreObject request to restore an object that is stored in a Cloud Storage Pool.
Supported request type
StorageGRID only supports RestoreObject requests to restore an object. It does not support the SELECT
type of restoration. Select requests return XNotImplemented
.
Versioning
Optionally, specify versionId
to restore a specific version of an object in a versioned bucket. If you don't specify versionId
, the most recent version of the object is restored
Behavior of RestoreObject on Cloud Storage Pool objects
If an object has been stored in a Cloud Storage Pool, a RestoreObject request has the following behavior, based on the state of the object. See HeadObject for more details.
If an object is stored in a Cloud Storage Pool and one or more copies of the object also exist on the grid, there is no need to restore the object by issuing a RestoreObject request. Instead, the local copy can be retrieved directly, using a GetObject request. |
State of object | Behavior of RestoreObject |
---|---|
Object ingested into StorageGRID but not yet evaluated by ILM, or object is not in a Cloud Storage Pool |
|
Object in Cloud Storage Pool but not yet transitioned to a non-retrievable state |
Note: Before an object has been transitioned to a non-retrievable state, you can't change its |
Object transitioned to a non-retrievable state |
Optionally, use the Important: If an object has been transitioned to S3 Glacier Deep Archive or the Cloud Storage Pool uses Azure Blob storage, you can't restore it using the |
Object in process of being restored from a non-retrievable state |
|
Object fully restored to the Cloud Storage Pool |
Note: If an object has been restored to a retrievable state, you can change its |