HeadObject
Returns the metadata of the object.
The method is equivalent to the GetObject method , but the object itself is missing from the response.

Request

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

Path parameters

Parameter
Description
bucket
Bucket name.
key
Object key.

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 .
Copy link