S3 Object Operations:Head Object

Search (SHIFT+S)




Head Object

HEAD /{object_name}?versionId={version_id}

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 optionalSet the range of bytes from the object to be returned
If-Modified-Since optionalEnsures 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 optionalEnsures 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 optionalIndicates 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 optionalIndicates 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 Body

Response indicating Success or Failure for this operation.

Notes: