
head-object
***********


DESCRIPTION
===========

The HEAD operation retrieves metadata from an object without returning
the object itself. This operation is useful if you''re only interested
in an object''s metadata. To use HEAD, you must have READ access to
the object.


SYNOPSIS
========

   aws s3 head-object
     --bucket <value>
     --key <value>
     [--if-unmodified-since <value>]
     [--version-id <value>]
     [--if-none-match <value>]
     [--range <value>]
     [--if-match <value>]
     [--if-modified-since <value>]


REQUIRED PARAMETERS
===================

"--bucket"  (string)

"--key"  (string)


OPTIONAL PARAMETERS
===================

"--if-unmodified-since"  (timestamp)Return the object only if it has
not been modified since the specified time, otherwise return a 412
(precondition failed).

"--version-id"  (string)--version-id used to reference a specific
version of the object.

"--if-none-match"  (string)Return the object only if its entity tag
(ETag) is different from the one specified, otherwise return a 304
(not modified).

"--range"  (string)Downloads the specified range bytes of an object.
For more information about the HTTP --range header, go to
http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35.

"--if-match"  (string)Return the object only if its entity tag (ETag)
is the same as the one specified, otherwise return a 412 (precondition
failed).

"--if-modified-since"  (timestamp)Return the object only if it has
been modified since the specified time, otherwise return a 304 (not
modified).
