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, Petabox 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 Petabox returns the code 304. For details, see RFC 7232 .
If-Unmodified-Since	If specified, Petabox 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 Petabox returns a code 200, and the requested data. See RFC 7232 for details .
If-Match	If specified, Petabox 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 Petabox returns a code 200, and the requested data. See RFC 7232 for details .
If-None-Match	If specified, Petabox 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 Petabox 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 .