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

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.

Sample Response

Sample Request

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

Sample Response



Copyright 2017 QueryIO Corporation. All Rights Reserved.

QueryIO, "Big Data Intelligence" and the QueryIO Logo are trademarks of QueryIO Corporation. Apache, Hadoop and HDFS are trademarks of The Apache Software Foundation.