S3 Object Operations:Get Object

Search (SHIFT+S)




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 optionalSets 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 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 optionalUsed 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 optionalUsed 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)

Notes: