Search (SHIFT+S)
ECS Management API
ECS Object Service API
-
Amazon S3
- S3 Bucket
- S3 Bucket ACL
- S3 Bucket Cors
- S3 Bucket Empty Status Operations
- S3 Bucket Is Stale Allowed
- S3 Bucket Lifecycle
- S3 Bucket List Fanout (Cloud DVR)
- S3 Bucket List Uploads
- S3 Bucket Location
- S3 Bucket Lock Configuration Operations
- S3 Bucket Object Lock Operations
- 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 Detailed Replication Status Operations
- S3 Object Init Uploads
- S3 Object Legal Hold Operations
- S3 Object Replication Info Operations
- S3 Object Retention Operations
- S3 Object Tagging Operations
- S3 Object Uploads
- S3 Options
- S3 Ping
- S3 Retention Update Operation
- S3 Select Operations
- EMC Atmos
- OpenStack Swift
ECS API Changes
Modified since last release
Get Object
GET /{object_name}[?versionId={version_id}]
Returns an object with the specified name from the specified bucket. By default, returns the latest version of the object. The versionID can be specified to retrieve a particular version of an object.
ECS also enables a specified byte range, or multiple specified byte ranges to be downloaded.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 | Sets the range of bytes from the object to be returned. To download multiple byte ranges use bytes=<start>-<end>, <start>-<end>, for example: bytes==4-8, 41-44. |
| 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 | Used to indicate 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 | Used to indicate 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 user 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
Only users with READ access to the object will be able to successfully invoke this operation
Response Body
Response indicating the status of the GET operation along with the object content(if available)