GetObject

Returns an object from ColdStack.
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 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 .

PutObject

HeadObject

Last modified 1yr ago

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.

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-Since`and `If-None-Match`and check it settled like `If-Modified-Since -> true`and `If-None-Match -> false`then 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-Since`and `If-Match`resolved as checks on them `If-Unmodified-Since -> false`, and `If-Match -> true`then ColdStack returns a code 200, and the requested data. See RFC 7232 for details .
`If-Match`	If specified, ColdStack returns: - Object. If it `ETag`matches the one passed. - Code 412. If it `ETag`does not match the transmitted one. If the request headers are present simultaneously `If-Unmodified-Since`and `If-Match`resolved as checks on them `If-Unmodified-Since -> false`, and `If-Match -> true`then ColdStack returns a code 200, and the requested data. See RFC 7232 for details .
`If-None-Match`	If specified, ColdStack returns: - Object. If its `ETag`not the same as the one passed. - Code 304. If it `ETag`matches the transmitted one. If the query at the same time there are headers `If-Modified-Since`and `If-None-Match`and check it settled like `If-Modified-Since -> true`and `If-None-Match -> false`then ColdStack returns the code 304. For details, see RFC 7232 .

Heading	Description
`x-amz-meta-*`	The custom metadata of the object, saved with the object.
`x-amz-storage-class`	Object storage class. Matters `COLD`if 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 .