get method
Returns an object from Object Storage.
Request
GET /{bucket}/{key} HTTP/2
Path parameters
Parameter | Description |
---|---|
bucket |
Bucket name. |
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. |
versionId |
Link to a specific version of the object. |
Headers
Use the necessary common request headers in requests.
You can also use the following headers in requests:
Header | 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: - Object. If it has been modified since the specified time. - Code 304. If the object hasn't 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 a 304 code. For more information, see RFC 7232 |
If-Unmodified-Since |
If specified, Object Storage returns: - Object. If it has not been modified since the specified time. - Code 412. If the object hasn't 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 a 200 code and the requested data. For more information, see RFC 7232 |
If-Match |
If specified, Object Storage returns: - Object. If its ETag matches the one sent.- Code 412. If its ETag doesn't match the one 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 a 200 code and the requested data. For more information, see RFC 7232 |
If-None-Match |
If specified, Object Storage returns: - Object. If its ETag matches the one sent.- Code 304. If its ETag matches the one sent.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 a 304 code. For more information, see RFC 7232 |
Response
Headers
In addition to common response headers, responses may contain:
Header | Description |
---|---|
X-Amz-Meta-* |
Object user-defined metadata. |
Response codes
For a list of possible responses, see Responses.