HEAD Object

Returns the metadata for an object. To use this operation, you must have READ access to the object.

The HEAD Object operation does not return a response body. Its response header is the same as for a GET Object operation.

Request syntax

HEAD /ObjectName HTTP/1.1
Host: BucketName.s3.amazonaws.com
Authorization: signatureValue
Date: date

Request headers

You can use the following common request headers with the GET Object operation:
Authorization, Content-Length, Content-Type, Date, Host, If-Match, If-Modified-Since, If-None-Match, If-Unmodified-Since, and Range.

The Authorization, Date, and Host headers are required; the others are optional.
For more information, see Request Headers.

Response headers

The HEAD Object operation may include the following response headers: Content-Length, Connection, Date, ETag, and Server. 

For more information, see Response Headers.


Request sample

This sample gets the metadata for the hosts object in the documentation bucket:

HEAD /documentation/hosts HTTP/1.1
Host: demo.cloud.it
Authorization: AWS pat:tvmFw6JAAR8E2U/9LLaklQh+H/I=
Date: Wed, 22 Jun 2011 16:04:02 GMT
Connection: close
Response sample
HTTP/1.1 200 OK
Date: Wed, 22 Jun 2011 16:04:02 GMT
Server: RestServer/1.0
Content-Length: 3507
Last-modified: Tue, 21 Jun 2011 12:32:06 GMT
Content-Type: binary/octet-stream
ETag: 03d6b34cd7f0328a2a079ef2f58e7bbc
Connection: close