-
Amazon S3
- S3 Bucket Acl Operations
- S3 Bucket Cors Operations
- S3 Bucket Is Stale Allowed Operations
- S3 Bucket Lifecycle Operation
- S3 Bucket List Uploads Operations
- S3 Bucket Location Operations
- S3 Bucket Operations
- S3 Bucket Versioning Operations
- S3 Bucket Versions Operations
- S3 Data Node Operation
- S3 Metadata Key List Operations
- S3 Metadata Key System List Operation
- S3 Metadata Search Operation
- S3 Multi Object Delete Operations
- S3 Object Acl Operations
- S3 Object Init Uploads Operations
- S3 Object Operations
- S3 Object Uploads Operations
- S3 Options Operations
- S3 Ping Operation
- EMC Atmos
- OpenStack SWIFT
- All Changes
-
Modified Services
- Data Store
- Password Group (Swift)
- S3 Bucket Acl Operations
- S3 Bucket Lifecycle Operation
- S3 Bucket Location Operations
- S3 Bucket Operations
- S3 Bucket Versioning Operations
- S3 Object Operations
- S3 Object Uploads Operations
- Secret Key
- Secret Key Self-Service
- Swift Account Operations
- Swift Container Operations
- Swift File Access Operations
- Swift Object Operations
- User (Object)
Get Object
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)