You can use the S3 GET Object request to retrieve an object from an S3 bucket.
GET Object by partNumber is not implemented
Using server-side encryption.
StorageGRID does not parse or interpret escaped UTF-8 characters in user-defined metadata. GET requests for an object with escaped UTF-8 characters in user-defined metadata do not return the x-amz-missing-meta header if the key name or value includes unprintable characters.
The following request header is not supported and returns XNotImplemented:
If a
versionId
subresource is not specified, the operation
fetches the most recent version of the object in a versioned
bucket. If the current version of the object is a delete marker,
a
Not Found
status is returned with the
x-amz-delete-marker
response header set to
true.
If an object has been stored in a Cloud Storage Pool (see the instructions for administering StorageGRID), the behavior of a GET Object request depends on the state of the
object. See HEAD Object
for more details.
State of object | Behavior of GET Object |
---|---|
Object ingested into StorageGRID but not yet evaluated by ILM, or object stored in a traditional storage pool or using erasure coding | 200 OK A copy of the object is retrieved. |
Object in Cloud Storage Pool but not yet transitioned to a non-retrievable state |
200 OK A copy of the object is retrieved. |
Object transitioned to a non-retrievable state |
403 Forbidden, InvalidObjectState Use a POST Object restore request to restore the object to a retrievable state. |
Object in process of being restored from a non-retrievable state |
403 Forbidden, InvalidObjectState Wait for the POST Object restore request to complete. |
Object fully restored to the Cloud Storage Pool |
200 OK A copy of the object is retrieved. |
If you uploaded a multipart object or if StorageGRID split a large object into segments, StorageGRID determines whether the object is available in the Cloud Storage Pool by sampling a subset of the object's parts or segments. In some cases, a GET Object request might incorrectly return 200 OK when some parts of the object have already been transitioned to a non-retrievable state or when some parts of the object have not yet been restored.