ColdStack Docs
Search…
ColdStack Docs
Introduction
ColdStack FAQ
Binance Smart Chain Bridge
Tools
Supported tools
S3 Compatible API
How to use the API
Signing Requests
API Reference
Bucket
Object
PutObject
GetObject
HeadObject
RenameObject
PutObjectAcl
Multipart upload
Analytics
Common request headers
Common response headers
Responses
Powered By GitBook
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 .
Previous
PutObject
Next
HeadObject
Last modified 1yr ago
Copy link
Contents
Request
Answer