GET Object

Description

Get object of QueryIO Server is used to fetch an object from server.

Requests

Syntax

• GET /queryio/<BucketName>/<ObjectName> HTTP/1.1
  Host: QueryIO.com
  authorization: <token>
  	

• <BucketName>: Path of the bucket which contains the object.
• <ObjectName>: Name of the object that will be retrieved.
• authorization: Token for authorization.

Request Headers

The GET operation in QueryIO Server uses following request headers:

Header Name	Description	Type	Defaults	Constraints	Required
Range	Returns the specified bytes of an object.	String	None	None	No
If-Modified-Since	If the object has been modified after the specified time, it returns object.	String	None	None	No
If-Unmodified-Since	If the object has not been modified after the specified time, it return object.	String	None	None	No
If-Match	If the entity tag(ETag) of the object is same as the specified one, it returns the object.	String	None	None	No
If-None-Match	If the entity tag(ETag) of the object is different from the specified one, it returns the object.	String	None	None	No
fetch-metadata	Passing this argument as true will fetch metadata for files as response headers. Value: true or false	Boolean	-	-	No

Examples

Sample Request with the Range Header

The following request specifies the HTTP Range header to retrieve first 10 bytes of an object.

• GET /queryio/DIR1/File1.txt HTTP/1.1
  Host: QueryIO.com
  authorization: iffo6l9hel2hfmbj2384joljgh9mqga58gb9if9593ucli9ke5s2e3854shhcmmm
  Range: bytes=0-9

Sample Response

• HTTP/1.1 206 Partial Content
  Content-Type: text/plain
  Content-Language: mi, en
  Expires: 2012-12-17 00:00:00
  Cache-Control: No-cache
  Content-Disposition: attachment
  Content-Encoding: x-gzip
  x-amz-request-id: 1350386026282911000_144715990
  x-amz-id-2: 1350386026282911000_144715990
  ETag: qs345tgfd5f27731c9771645a7853216
  Last-Modified: 2012-10-10 01:10:00

Sample Request with the If-Modified-Since Header

The following request specifies the HTTP If-Modified-Since header to retrieve an object if it is modified after the given time.

• GET /queryio/DIR1/File1.txt HTTP/1.1
  Host: QueryIO.com
  authorization: iffo6l9hel2hfmbj2384joljgh9mqga58gb9if9593ucli9ke5s2e3854shhcmmm
  If-Modified-Since: 2012-4-17 12:00:00

Sample Response

• HTTP/1.1 200 OK
  Content-Type: text/plain
  Content-Language: mi, en
  Expires: 2012-12-17 00:00:00
  Cache-Control: No-cache
  Content-Disposition: attachment
  Content-Encoding: x-gzip
  x-amz-request-id: 1350386037572942000_144715990
  x-amz-id-2: 1350386037572942000_144715990
  ETag: qs345tgfd5f27731c9771645a7853216
  Last-Modified: 2012-6-17 05:50:00

Sample Request with the If-Unmodified-Since Header

The following request specifies the HTTP If-Unmodified-Since header to retrieve an object if it is not modified after the given time.

• GET /queryio/DIR1/File1.txt HTTP/1.1
  Host: QueryIO.com
  Authorization: iffo6l9hel2hfmbj2384joljgh9mqga58gb9if9593ucli9ke5s2e3854shhcmmm
  If-Modified-Since: 2012-6-17 05:50:00

Sample Response

• HTTP/1.1 409 Conflict
  Content-Type: text/plain
  Content-Language: mi, en
  Expires: 2012-12-17 00:00:00
  Cache-Control: No-cache
  Content-Disposition: attachment
  Content-Encoding: x-gzip
  x-amz-request-id: 1350386432172942000_144715990
  x-amz-id-2: 1350386432172942000_144715990
  ETag: qs345tgfd5f27731c9771645a7853216
  Last-Modified: 2012-10-17 00:00:00

Sample Request with the If-Match Header

The following request specifies the HTTP If-Match header to retrieve an object if its entity tag is same as specified.

• GET /queryio/DIR1/File1.txt HTTP/1.1
  Host: QueryIO.com
  authorization: iffo6l9hel2hfmbj2384joljgh9mqga58gb9if9593ucli9ke5s2e3854shhcmmm
  If-Match: "881f7881ac1bc144a2672e45babb8839"

Sample Response

• HTTP/1.1 200 OK
  Content-Type: text/plain
  Content-Language: mi, en
  Expires: 2012-12-17 00:00:00
  Cache-Control: No-cache
  Content-Disposition: attachment
  Content-Encoding: x-gzip
  x-amz-request-id: 1350386987652942000_144715990
  x-amz-id-2: 1350386987652942000_144715990
  ETag: 881f7881ac1bc144a2672e45babb8839
  Last-Modified: 2012-09-17 14:32:38

Sample Request with the If-None-Match Header

The following request specifies the HTTP If-None-Match header to retrieve an object if its entity tag is not same as specified.

• GET /queryio/DIR1/File1.txt HTTP/1.1
  Host: QueryIO.com
  authorization: iffo6l9hel2hfmbj2384joljgh9mqga58gb9if9593ucli9ke5s2e3854shhcmmm
  If-None-Match: "881f7881ac1bc144a2672e45babb8839"

Sample Response

• HTTP/1.1 200 OK
  Content-Type: text/plain
  Content-Language: mi, en
  Expires: 2012-12-17 00:00:00
  Cache-Control: No-cache
  Content-Disposition: attachment
  Content-Encoding: x-gzip
  x-amz-request-id: 1350386654357942000_144715990
  x-amz-id-2: 1350386654357942000_144715990
  ETag: qs345tgfd5f27731c9771645a7853216
  Last-Modified: 2012-08-07 15:50:14