GetObject
Returns an object from ColdStack.

Request

1
GET /{bucket}/{key} HTTP/1.1
Copied!

Path parameters

Parameter
Description
bucket
Bucket name.
key
Object key.

Query parameters

Parameter
Description
response-content-type
Sets the header of the response Content-Type.
response-content-language
Sets the header of the response Content-Language.
response-expires
Sets the header of the response Expires.
response-cache-control
Sets the header of the response Cache-Control.
response-content-disposition
Sets the header of the response Content-Disposition.
response-content-encoding
Sets the header of the response Content-Encoding.
version-id
A link to a specific version of the object.

Headings

Use the required common headers in the request .
You can also use the following headers in the request:
Heading
Description
Range
Specifies the range of bytes to load from the object. Read more about the Range header in the HTTP specification http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35 .
If-Modified-Since
If specified, ColdStack returns: - Object. If it changed after the specified time. - Code 304. If the object has not changed after the specified time. If the query at the same time there are headers If-Modified-Sinceand If-None-Matchand check it settled like If-Modified-Since -> trueand If-None-Match -> falsethen ColdStack returns the code 304. For details, see RFC 7232 .
If-Unmodified-Since
If specified, ColdStack returns: - Object. If it hasn't changed since the specified time. - Code 412. If the object has not changed since the specified time. If the request headers are present simultaneously If-Unmodified-Sinceand If-Matchresolved as checks on them If-Unmodified-Since -> false, and If-Match -> truethen ColdStack returns a code 200, and the requested data. See RFC 7232 for details .
If-Match
If specified, ColdStack returns: - Object. If it ETagmatches the one passed. - Code 412. If it ETagdoes not match the transmitted one. If the request headers are present simultaneously If-Unmodified-Sinceand If-Matchresolved as checks on them If-Unmodified-Since -> false, and If-Match -> truethen ColdStack returns a code 200, and the requested data. See RFC 7232 for details .
If-None-Match
If specified, ColdStack returns: - Object. If its ETagnot the same as the one passed. - Code 304. If it ETagmatches the transmitted one. If the query at the same time there are headers If-Modified-Sinceand If-None-Matchand check it settled like If-Modified-Since -> trueand If-None-Match -> falsethen ColdStack returns the code 304. For details, see RFC 7232 .

Answer

Headings

In addition to the general headers, you can see the headers listed in the table below in the response.
Heading
Description
x-amz-meta-*
The custom metadata of the object, saved with the object.
x-amz-storage-class
Object storage class. Matters COLDif the object is in Cold Storage. If the object is saved in the Standard storage, then there will be no title.
x-amz-server-side-encryption
The encryption algorithm used to encrypt the object. Returned if the object was loaded with encryption enabled .
x-amz-server-side-encryption-aws-kms-key-id
KMS key identifier . Returned if the object was loaded with encryption enabled .

Answer codes

For a list of possible answers, see the Answers section .
Last modified 1yr ago
Copy link