get method
Returns an object from Object Storage.
Request
GET /{bucket}/{key} HTTP/2
Path parameters
| Parameter | Description |
|---|---|
bucket |
Bucket name. |
key |
Object key. |
Request parameters
| Parameter | Description |
|---|---|
response-content-type |
It sets the Content-Type response header. |
response-content-language |
It sets the Content-Language response header. |
response-expires |
It sets the Expires response header. |
response-cache-control |
It sets the Cache-Control response header. |
response-content-disposition |
It sets the Content-Disposition response header. |
response-content-encoding |
It sets the Content-Encoding response header. |
versionId |
Link to a specific version of the object. |
Headers
Use the appropriate common headers in your request.
You can also use the following headers in your request:
| Header | Description |
|---|---|
Range |
It defines the range of bytes to load 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 following: - 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, Object Storage returns a 304 code. For more information, see RFC 7232. |
If-Unmodified-Since |
If it is specified, Object Storage returns the following: - Object. If it has not been modified since the specified time. - Code 412. If the object has 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, Object Storage returns a 200 code and the requested data. For more information, see RFC 7232. |
If-Match |
If it is specified, Object Storage returns the following: - Object. If its ETag matches the provided one.- Code 412. If its ETag does not match the provided 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, Object Storage returns a 200 code and the requested data. For more information, see RFC 7232. |
If-None-Match |
If it is specified, Object Storage returns the following: - Object. If its ETag does not match the provided one.- Code 304. If its ETag matches the provided 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, Object Storage returns a 304 code. For more information, see RFC 7232. |
Response
Headers
In addition to common headers, you can see in a response the headers listed in the table below.
| Header | Description |
|---|---|
X-Amz-Meta-* |
User-defined object metadata. |
X-Amz-Storage-Class |
Storage class of the object. It takes the COLD value if the object is in a cold storage, or ICE, if it is in an ice storage.If the object is in a standard storage, there is no header. |
X-Amz-Server-Side-Encryption |
Encryption algorithm used to encrypt the object. It is returned if the object was uploaded with encryption enabled. |
X-Amz-Server-Side-Encryption-Aws-Kms-Key-Id |
ID of the KMS key. It is returned if the object was uploaded with encryption enabled. |
X-Amz-Object-Lock-Mode |
Type of retention put on the object (if the bucket is versioned and object lock is enabled in it):
For an object version, you can use only retention (the |
X-Amz-Object-Lock-Retain-Until-Date |
Retention end date and time in any format described in the HTTP standard, e.g., Mon, 12 Dec 2022 09:00:00 GMT. Specify it only with the X-Amz-Object-Lock-Mode header. |
X-Amz-Object-Lock-Legal-Hold |
Type of legal hold put on the object (if the bucket is versioned and object lock is enabled in it):
For an object version, you can use only retention (the |
Response codes
For a list of possible responses, see Responses.