Menu
Amazon Simple Storage Service
API Reference (API Version 2006-03-01)

GET Service

Description

This implementation of the GET operation returns a list of all buckets owned by the authenticated sender of the request.

To authenticate a request, you must use a valid AWS Access Key ID that is registered with Amazon S3. Anonymous requests cannot list buckets, and you cannot list buckets that you did not create.

Requests

Syntax

GET / HTTP/1.1
Host: s3.amazonaws.com
Date: date
Authorization: authorization string (see Authenticating Requests (AWS Signature Version
		4))

Request Parameters

This implementation of the operation does not use request parameters.

Request Headers

This implementation of the operation uses only request headers that are common to all operations. For more information, see Common Request Headers.

Request Elements

This implementation of the operation does not use request elements.

Responses

Response Elements

Name Description
Bucket

Container for bucket information.

Type: Container

Children: Name, CreationDate

Ancestor: ListAllMyBucketsResult.Buckets

Buckets

Container for one or more buckets.

Type: Container

Children: Bucket

Ancestor: ListAllMyBucketsResult

CreationDate

Date the bucket was created.

Type: date ( of the form yyyy-mm-ddThh:mm:ss.timezone, e.g., 2009-02-03T16:45:09.000Z)

Ancestor: ListAllMyBucketsResult.Buckets.Bucket

DisplayName

Bucket owner's display name.

Type: String

Ancestor: ListAllMyBucketsResult.Owner

ID

Bucket owner's user ID.

Type: String

Ancestor: ListAllMyBucketsResult.Owner

ListAllMyBucketsResult

Container for response.

Type: Container

Children: Owner, Buckets

Ancestor: None

Name

Bucket's name.

Type: String

Ancestor: ListAllMyBucketsResult.Buckets.Bucket

Owner

Container for bucket owner information.

Type: Container

Ancestor: ListAllMyBucketsResult

Special Errors

This implementation of the operation does not return special errors. For general information about Amazon S3 errors and a list of error codes, see Error Responses.

Examples

Sample Request

The GET operation on the Service endpoint (s3.amazonaws.com) returns a list of all of the buckets owned by the authenticated sender of the request.

GET / HTTP/1.1
Host: s3.amazonaws.com
Date: Wed, 01 Mar  2006 12:00:00 GMT
Authorization: authorization string

Sample Response

<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01">
  <Owner>
    <ID>bcaf1ffd86f461ca5fb16fd081034f</ID>
    <DisplayName>webfile</DisplayName>
  </Owner>
  <Buckets>
    <Bucket>
      <Name>quotes</Name>
      <CreationDate>2006-02-03T16:45:09.000Z</CreationDate>
    </Bucket>
    <Bucket>
      <Name>samples</Name>
      <CreationDate>2006-02-03T16:41:58.000Z</CreationDate>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>