get method

Returns an object from Object Storage.

Request

GET /{bucket}/{key} HTTP/1.1

Path parameters

Parameter Description
bucket Name of the bucket.
key Object key.

Query parameters

Parameter Description
response-content-type Sets the Content-Type response header.
response-content-language Sets the Content-Language response header.
response-expires Sets the Expires response header.
response-cache-control Sets the Cache-Control response header.
response-content-disposition Sets the Content-Disposition response header.
response-content-encoding Sets the Content-Encoding response header.

Headers

In a request, use the necessary common request headers.

You can also use the following headers in requests:

Header name Description
Range Sets the byte range to be uploaded from the object.

For more information about the Range header, see the HTTP specification http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35.
If-Modified-Since If specified, Object Storage returns:
- The object. If it has been modified since the specified time.
- Code 304. If the object has not been modified since the specified time.

If a request has both the If-Modified-Since and If-None-Match headers and their checks result in If-Modified-Since -> true and If-None-Match -> false, then Object Storage returns 304. For more information, see RFC 7232.
If-Unmodified-Since If specified, Object Storage returns:
- The object. If it has not been modified since the specified time.
- Code 412. If the object has not been modified since the specified time.

If a request has both the If-Unmodified-Since and If-Match headers and their checks result in If-Unmodified-Since -> false and If-Match -> true, then Object Storage returns 412 and the requested data. For more information, see RFC 7232.
If-Match If specified, Object Storage returns:
- The object. If its ETag matches the sent one.
- Code 412. If its ETag doesn't match the sent one.


If a request has both the If-Unmodified-Since and If-Match headers and their checks result in If-Unmodified-Since -> false and If-Match -> true, then Object Storage returns 200 and the requested data. For more information, see RFC 7232.
If-None-Match If specified, Object Storage returns:
- The object. If its ETag doesn't match the sent one.
- Code 304. If its ETag matches the sent one.


If a request has both the If-Modified-Since and If-None-Match headers and their checks result in If-Modified-Since -> true and If-None-Match -> false, then Object Storage returns 304. For more information, see RFC 7232.

Response

Headers

In addition to common response headers, responses may have headers listed in the table below.

Header name Description
x-amz-meta-* User-defined object metadata that is stored with the object.
x-amz-storage-class Object storage class.
The value is COLD if the object is stored in cold storage.

If it is stored in standard storage, the header is omitted.

Response codes

For a list of possible responses, see Responses.