GET Bucket (List Objects)

Latest revision as of 13:36, 30 May 2016

Returns ome or all of the objects in a bucket

GET /

[edit] 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.

[edit] 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.

[edit] Examples

Sample Request

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

Sample Response

<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>