Search (SHIFT+S)
ECS Management API
ECS Object Service API
-
Amazon S3
- S3 Bucket
- S3 Bucket ACL
- S3 Bucket Cors
- S3 Bucket Is Stale Allowed
- S3 Bucket Lifecycle
- S3 Bucket List Uploads
- S3 Bucket Location
- S3 Bucket Policy
- S3 Bucket Versioning
- S3 Bucket Versions
- S3 Data Node
- S3 Metadata Key List
- S3 Metadata Key System List
- S3 Metadata Search
- S3 Multi Object Delete
- S3 Object
- S3 Object ACL
- S3 Object Init Uploads
- S3 Object Replication Info Operations
- S3 Object Tagging Operations
- S3 Object Uploads
- S3 Options
- S3 Ping
- S3 Retention Update Operation
- EMC Atmos
- OpenStack Swift
ECS API Changes
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 | 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 Body
Response indicating Success or Failure for this operation.