Corinne.chui: 1 revision

2016-05-30T19:36:50Z

1 revision

Mike.robski at 13:26, 20 May 2013

2013-05-20T13:26:29Z

New page

Returns ome or all of the objects in a bucket

'''GET''' /

== Requests ==
; Syntax

GET / HTTP/1.1
Host: ''BucketName''.hostway.com
Date: ''date''
Authorization: ''signatureValue''

; Parameters
* delimiter: character you use to group keys
* marker: key to start with when listing objects in a a bucket
* max-keys: maximum number of keys returned in the response body
* prefix: limits the rseponse to keys that begin with the specified prefix
; Headers
This implementation of the operation only uses request headers common to all operations
; Elements in body
This implementation of the operation does not use request elements.

== Responses ==
; Headers
This implementation of the operation uses only response headers that are common to most responses
; Elements
* Contents: Metadata about each object returned.
* CommonPrefixes: only if you specify a delimiter, contains all (if there are any) keys between Prefix and the next occurrence of the string specified by delimiter.
* Delimiter: Causes keys that contain the same string between the prefix and the first occurrence of the delimiter to be rolled up into a single result element in the CommonPrefixes collection
* DisplayName: Object owner's name.
* ETag: MD5 hash of the object
* ID: Object owner's ID.
* IsTruncated: Specifies whether (true) or not (false) all of the results were returned
* Key: The object's key.
* LastModified: Date and time the object was last modified.
* Marker: Indicates where in the bucket to begin listing.
* MaxKeys: The maximum number of keys returned in the response body.
* Name: Name of the bucket.
* Owner: Bucket owner.
* Prefix: Keys that begin with the indicated prefix.
* Size: Size in bytes of the object.
* StorageClass: Always STANDARD.

== Examples ==
; Sample Request

GET / HTTP/1.1
Host: ''BucketName''.hs2.hostway.com
Date: ''date''
Authorization: AWS ''signatureValue''
Content-Type: text/plain

; Sample Response
<nowiki>
<ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Name>fitnesse</Name>
<Delimiter />
<MaxKeys>1000</MaxKeys>
<Prefix />
<Marker />
<IsTruncated>false</IsTruncated>
<Contents>
<LastModified>2012-05-04T07:22:59.000Z</LastModified>
<ETag>"b97347d2fb66c24bdafee7934bc873af"</ETag>
<StorageClass>STANDARD</StorageClass>
<Key>hs2-copy.txt</Key>
<Owner>
<DisplayName>youngbae.oh@hostwaycorp.com</DisplayName>
<ID>d45dc7d25125281926cac849e6ae78374f200ee1e8072e389d000026b1899d1a</ID>
</Owner>
<Size>14</Size>
</Contents>
<Contents>
<LastModified>2012-05-03T21:43:18.000Z</LastModified>
<ETag>"b97347d2fb66c24bdafee7934bc873af"</ETag>
<StorageClass>STANDARD</StorageClass>
<Key>hs2-monitoring.txt</Key>
<Owner>
<DisplayName>youngbae.oh@hostwaycorp.com</DisplayName>
<ID>d45dc7d25125281926cac849e6ae78374f200ee1e8072e389d000026b1899d1a</ID>
</Owner>
<Size>14</Size>
</Contents>
</ListBucketResult>
</nowiki>

[[Category:Hostway API]]
[[Category:Hostway Simple Storage API]]

GET Bucket (List Objects) - Revision history

Corinne.chui: 1 revision

Mike.robski at 13:26, 20 May 2013