listBuckets method

Returns a list of buckets available to the user.

Request

GET / HTTP/1.1

Headers

In a request, use only common request headers.

Response

Headers

A response can only contain common response headers.

Response codes

For a list of possible responses, see Responses.

A successful response contains additional data in XML format with the schema described below.

Data schema

<ListAllMyBucketsResult>
  <Buckets>
    <Bucket>
      <Name>bucket-name</Name>
      <CreationDate>date_time</CreationDate>
    </Bucket>
    ...
  </Buckets>
</ListAllMyBucketsResult>
Element Description
Bucket Contains a bucket description.

Path: /ListAllMyBucketsResult/Buckets/Bucket.
Buckets Contains a list of buckets.

Path: /ListAllMyBucketsResult/Buckets.
CreationDate Bucket creation time in the format yyyy-mm-ddThh:mm:ss.timezone.

Path: /ListAllMyBucketsResult/Buckets/Bucket/CreationDate.
ListAllMyBucketsResult Response root element.

Path: /ListAllMyBucketsResult.
Name Bucket name.

Path: /ListAllMyBucketsResult/Buckets/Bucket/Name.