Download an object

Edit online

A GET given a path to an object downloads the object. This operation does not make use of operation specific query parameters (besides versioning) or payload elements.

Syntax


GET https://{endpoint}/{bucket-name}/{object-name} # path style
GET https://{bucket-name}.{endpoint}/{object-name} # virtual host style

Optional headers

Header	Type	Description
`range`	string	Returns the bytes of an object within the specified range.
`x-amz-storage-class`	string	Return the storage class if set in the COS Manager in container mode.
`x-amz-tagging-count`	integer	The number of tags associated with an object. This field is only included if there are tags associated with the object.
`x-amz-checksum-mode`	String (ENABLED is the only valid value)	This indicates whether or not to include checksum metadata on the response.
`x-amz-replication-status`	String	Returns `REPLICA` if this object was replicated from a source bucket as a result of bucket replication policy. Header is omitted otherwise.

Specific headers for SSE-C

Common SSE-C headers are available for buckets using Server Side Encryption with Customer-Provided Keys (SSE-C) enabled.

Specific response headers for Object Lock

Note: Non-bucket owners uploading objects to an Object Lock enabled bucket will have default retention of the bucket applied , if configured on the bucket. Otherwise no retention will be applied to the object.

Table 1. Object Lock response headers
Header	Type	Description
`x-amz-object-lock-mode`	string	The object lock mode applied to the uploaded object.
`x-amz-object-lock-retain-until-date`	string	The date and time that the uploaded object’s Object Lock is to expire.
`x-amz-object-lock-legal-hold`	string	Specifies if a Legal Hold is be applied to the object.

Sample request


GET /example-bucket/worker-bee HTTP/1.1
Authorization: {authorization-string}
x-amz-date: 20160825T183244Z
Host: 67.228.254.193

Sample response


HTTP/1.1 200 OK
Date: Thu, 25 Aug 2016 18:34:25 GMT
X-Clv-Request-Id: 116dcd6b-215d-4a81-bd30-30291fa38f93
Accept-Ranges: bytes
Server: Cleversafe/3.9.0.121
X-Clv-S3-Version: 2.5
x-amz-tagging-count: 9
ETag: "d34d8aada2996fc42e6948b926513907"
Content-Type: text/plain; charset=UTF-8
Last-Modified: Thu, 25 Aug 2016 17:46:53 GMT
Content-Length: 467

 Female bees that are not fortunate enough to be selected to be the 'queen'
 while they were still larvae become known as 'worker' bees. These bees lack
 the ability to reproduce and instead ensure that the hive functions smoothly,
 acting almost as a single organism in fulfilling their purpose.

Sample response with Object Lock


HTTP/1.1 200 OK
Date: Thu, 25 Aug 2016 18:34:25 GMT
X-Clv-Request-Id: 116dcd6b-215d-4a81-bd30-30291fa38f93
Accept-Ranges: bytes
Server: Cleversafe/3.9.0.121
X-Clv-S3-Version: 2.5
x-amz-tagging-count: 9
ETag: "d34d8aada2996fc42e6948b926513907"
Content-Type: text/plain; charset=UTF-8
Last-Modified: Thu, 25 Aug 2016 17:46:53 GMT
Content-Length: 467
x-amz-object-lock-mode = COMPLIANCE
x-amz-object-lock-retain-until-date = <ISO8601 date and time>
x-amz-object-lock-legal-hold = ON

 Female bees that are not fortunate enough to be selected to be the 'queen'
 while they were still larvae become known as 'worker' bees. These bees lack
 the ability to reproduce and instead ensure that the hive functions smoothly,
 acting almost as a single organism in fulfilling their purpose.