Get the headers of an object

Edit online

A HEAD given a path to an object retrieves that object’s headers. This operation does not make use of operation specific query parameters (besides versioning) or payload elements.

Syntax


HEAD https://{endpoint}/{bucket-name}/{object-name} # path style
HEAD https://{bucket-name}.{endpoint}/{object-name} # virtual host style

Optional headers

Note: Only bucket owners have permissions to see the object lock headers for objects with Object Lock protection applied on the object.

Header	Type	Description
`range`	string	Returns the bytes of an object within the specified range.
Mirror-Destination	string	This header is applicable for listing of buckets in a protected mirror. The Mirror-Destination header specifies from which vault of the mirror to read. By default, if no explicit vault is specified, then the listing request will attempt to read from both vaults and provide a listing response that combines the list of objects on each component vault to the mirror excluding duplicates (object resides on both vaults in the mirror). If the Mirror-Destination header is specified and includes a valid Vault Identifier, the data returned will be from the Vault with the ID that matches what was provided in the header. The Mirror-Destination header is applicable only to protected mirrors, and the header is ignored otherwise. A failure to read from the specified vault will result in an error back to the HTTP client. Type String Default None Constraints {Valid Vault Identifier}
`x-amz-tagging-count`	integer	The number of tags associated with an object. This field is only included if there are tags associated with the object.
`x-amz-checksum-mode`	String (ENABLED is the only valid value)	This indicates whether or not to include checksum metadata on the response.
`x-amz-replication-status`	String	Returns `REPLICA` if this object was replicated from a source bucket as a result of bucket replication policy. Header is omitted otherwise.
`x-amz-object-lock-mode`	string	The object lock mode applied to the uploaded object.
`x-amz-object-lock-retain-until-date`	string	The date and time that the uploaded object’s Object Lock is to expire.
`x-amz-object-lock-legal-hold`	string	Specifies if a Legal Hold is be applied to the object.

Specific headers for SSE-C

Common SSE-C headers are available for buckets using Server Side Encryption with Customer-Provided Keys (SSE-C) enabled.

Sample request


HEAD /example-bucket/soldier-bee HTTP/1.1
Authorization: {authorization-string}
x-amz-date: 20160825T183244Z
Host: 67.228.254.193

Sample response


HTTP/1.1 200 OK
Date: Thu, 25 Aug 2016 18:32:44 GMT
X-Clv-Request-Id: da214d69-1999-4461-a130-81ba33c484a6
Accept-Ranges: bytes
Server: Cleversafe/3.9.0.121
X-Clv-S3-Version: 2.5
x-amz-request-id: da214d69-1999-4461-a130-81ba33c484a6
x-amz-tagging-count: 9
ETag: "37d4c94839ee181a2224d6242176c4b5"
Content-Type: text/plain; charset=UTF-8
Last-Modified: Thu, 25 Aug 2016 17:49:06 GMT
Content-Length: 11