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

HEAD /{bucket}/{key} HTTP/1.1

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 .

Last updated