GET Bucket

Description

GET Bucket operation of QueryIO server will fetch all the objects from the bucket. Request Parameters can be used to retrieve subset of objects from bucket.

Requests

Syntax

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

• BucketName: Name of the bucket from which objects will be returned.
• authorization: Token for authorization.

Request Headers

The GET operation in QueryIO Server uses following request headers:

Header Name	Description	Type	Default	Required
prefix	Only keys that begin with specified prefix are returned.	String	None	No
delimiter	Delimiter is used to group keys together as CommonPrefix.Keys that contain same string between the prefix and delimiter are grouped together.	String	None	No
max-keys	Sets the upper limit to the keys returned in response. There might be fewer keys than max-keys	String	100	No
marker	It is used to specify the order of keys displayed.(Alphabetically)	String	None	No

Responses

Response Elements

The GET operation in QueryIO Server uses following response elements:

Name	Description	Type
Contents	Contains metadata about each object.	XML metadata
CommonPrefixes	CommonPrefixes exist only if a delimiter is specified. It contain all keys that contains substring between prefix and delimiter. .	String
Delimiter	Delimiter which is used to group keys. Keys that contain same string between the prefix and delimiter are grouped together as CommonPrefixes.	String
DisplayName	Name of Object's owner.	String
ETag	Etag is MD5 hash result of the object.	String
ID	ID of the Object's owner.	String
IsTruncated	Is true if result is truncated due to max-keys.Otherwise it is true.	String
Key	The object's key.	String
LastModified	Last modified date and time of Object.	Date
Marker	Indicates where in the bucket to begin listing.	String
MaxKeys	Specifies the maximum number of keys that will be returned.	String
Name	Name of the bucket.	String
Owner	Owner of the bucket. Children: DisplayName, ID	String
Prefix	Keys that begin with the specified prefix.	String
Size	Size of the object in bytes	String
StorageClass	It is always STANDARD.	String

Examples

Sample Request

The following request will fetch objects from NewBucket.

• GET /queryio/DIR1 HTTP/1.1
  Host: QueryIO
  authorization: iffo6l9hel2hfmbj2384joljgh9mqga58gb9if9593ucli9ke5s2e3854shhcmmm

Sample Response

• <xml version="1.0" encoding="UTF-8">
  <ListBucketResult xmlns="http://QueryIO/DIR1">
      <Name>DIR1</Name>
      <Prefix></Prefix>
      <Marker></Marker>
      <MaxKeys>1000</MaxKeys>
      <IsTruncated>false</IsTruncated>
      <Contents>
          <Key>hdfs.txt</Key>
          <LastModified>2012-10-17 23:00:30</LastModified>
          <ETag>ss23kgfd5f27731c9771293j7853216</ETag>
          <Size>128</Size>
          <StorageClass>STANDARD</StorageClass>
          <Owner>
              <ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
              <DisplayName>abc</DisplayName>
          </Owner>
      </Contents>
      <Contents>
         <Key>myfile.jpg</Key>
           <LastModified>2012-09-27 12:21:30</LastModified>
          <ETag>ak234e5fd5f27731c9771645a7853216</ETag>
          <Size>64994</Size>
          <StorageClass>STANDARD</StorageClass>
          <Owner>
              <ID>1350306728657652000_719148673</ID>
              <DisplayName>hdfs</DisplayName>
          </Owner>
      </Contents>
  </ListBucketResult>

Sample Request

This example lists up to 10 keys in the "NewBucket" bucket that start with "A" and occur alphabetically after "App".

• GET prefix=A&marker=App&max-keys=10 /queryio/DIR1 HTTP/1.1
  Host: QueryIO.com
  authorization: iffo6l9hel2hfmbj2384joljgh9mqga58gb9if9593ucli9ke5s2e3854shhcmmm

Sample Response

• <xml version="1.0" encoding="UTF-8">
  <ListBucketResult xmlns="http://QueryIO/DIR1">
    <Name>AppPerfect</Name>
    <Prefix>A</Prefix>
    <Marker>App</Marker>
    <MaxKeys>10</MaxKeys>
    <IsTruncated>false</IsTruncated>
    <Contents>
      <Key>App4evr</Key>
      <LastModified>2012-10-15 22:46:30</LastModified>
      <ETag>assdj23fd5f27731c977as23e7853216</ETag>
      <Size>256</Size>
      <StorageClass>STANDARD</StorageClass>
      <Owner>
        <ID>135030564667652000_719148673</ID>
        <DisplayName>Appforyou</DisplayName>
       </Owner>
    </Contents>
    <Contents>
      <Key>Apple</Key>
      <LastModified>2012-09-27 20:24:11</LastModified>
      <ETag>qs345tsk3m27731c97725sd57853216</ETag>
      <Size>10248</Size>
      <StorageClass>STANDARD</StorageClass>
       <Owner>
        <ID>1350306721234562000_719148673</ID>
        <DisplayName>webfile</DisplayName>
      </Owner>
   </Contents>
  </ListBucketResult>