get method

Written by

Request
Response
- Headers
- Response codes

Returns an object from Object Storage.

Request

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

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.

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: - The 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: - The 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: - The object. If its `ETag` matches the sent one. - Code 412. If its `ETag` doesn't match the one sent. 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: - The object. If its `ETag` doesn't match the sent one. - 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 have headers listed in the table below.

Header	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.