GET Object

Retrieves objects from the storage system. READ access for the object is required to use the GET Object operation. Authorization headers are required unless you grant READ access to the anonymous user.

Request syntax

GET /ObjectName HTTP/1.1
Date: date
Authorization: signatureValue

Request headers

You can use the following common request headers with the GET Object operation:
Authorization, Content-Length, Content-Type, Date, Host, If-Match, If-Modified-Since, If-None-Match, If-Unmodified-Since, and Range.

The Authorization, Date, and Host headers are required; the others are optional.
For more information, see Request Headers.

Response headers

The GET Object operation may include the following response headers: Content-Length, Connection, Date, ETag, and Server. 

For more information, see Response Headers.


Request sample

This sample gets the hosts object from the docs bucket:

GET /hosts HTTP/1.1
Authorization: AWS pat:Uzu5dUnFSauFrl1+i97ZpLvYBYM=
Date: Tue, 21 Jun 2011 12:32:24 GMT


Response sample
HTTP/1.1 200 OK
Date: Tue, 21 Jun 2011 12:32:24 GMT
Server: RestServer/1.0
Content-Length: 3507
Last-modified: Tue, 21 Jun 2011 12:32:06 GMT
Content-Type: binary/octet-stream
ETag: 03d6b34cd7f0328a2a079ef2f58e7bbc
Connection: close
Request sample with the Range header

This sample requests all of the tar.gz file object bytes from position 3752576 to the end of the file:

GET /backup-axes02/ HTTP/1.1
Range: bytes=3752576-
Date: Tue, 21 Jun 2011 13:05:05 GMT
Authorization: AWS pat:fXhYiNTWc15sscl4Ncf4sIj9F0M=
Response sample for the request with Range header
HTTP/1.1 206 Partial Content
Date: Tue, 21 Jun 2011 13:07:29 GMT
Server: RestServer/1.0
Content-Length: 81755593
Last-modified: Tue, 14 Jun 2011 03:01:29 GMT
Content-Type: application/x-tar
ETag: 3d832bc84f1cb6d2254f50905db94df0
Content-Range: bytes 15132027-96887619/96887620
Connection: close