• S3 Object

Head Object

Retrieves metadata from an object without returning the object itself.

URL Format

Host Style: http://bucketname.ns1.emc.com/{object_name}?versionId={version_id}
Path Style: http://ns1.emc.com/bucketname/{object_name}?versionId={version_id}

Alternatively, both styles can specify the namespace using the x-emc-namespace header.

Request Headers

Range	optional	Set the range of bytes from the object to be returned
If-Modified-Since	optional	Ensures the object is returned only if it has been MODIFIED since the specified time. 304(not modified) HTTP Response code is returned otherwise
If-Unmodified-Since	optional	Ensures the object is returned only if it has NOT been MODIFIED since the specified time. 412(precondition failed) HTTP Response Code is returned otherwise
If-Match	optional	Indicates that the object should be returned only if its entity tag(ETag) is the SAME as this header value. 412(precondition failed) HTTP Response Code is returned otherwise
If-None-Match	optional	Indicates that the object should be returned only if its entity tag is NOT the SAME as this header value. 304(not modified) HTTP Response code is returned otherwise

---

Prerequisites

The following conditions must be met in order to call this operation.

• The users must have READ access to the object

• BaseUrl used in a host-style request URL should be pre-configured using the ECS Management API or the ECS Portal (for example, emc.com in the URL: bucketname.ns1.emc.com).

• Namespace and bucket corresponding to this object should exist

---

Request Payload

No Request Payload

---

Response Headers

fanout-copy-size	optional	Returns fanout-specific response headers along with other response headers if the object is a fanout object.
fanout-copy-count	optional	Returns fanout-specific response headers along with other response headers if the object is a fanout object.

---

Response Body

Response indicating Success or Failure for this operation.