Amazon Simple Storage Service
API Reference (API Version 2006-03-01)
AWS services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with AWS services in China.

GET Service


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.



GET / HTTP/1.1 Host: 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.


Response Elements

Name Description

Container for bucket information.

Type: Container

Children: Name, CreationDate

Ancestor: ListAllMyBucketsResult.Buckets


Container for one or more buckets.

Type: Container

Children: Bucket

Ancestor: ListAllMyBucketsResult


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


Bucket owner's display name.


This value is only included in the response in the US East (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), EU (Ireland), and South America (São Paulo) regions.

For a list of all the Amazon S3 supported regions and endpoints, see Regions and Endpoints in the AWS General Reference.

Type: String

Ancestor: ListAllMyBucketsResult.Owner


Bucket owner's canonical user ID.

Type: String

Ancestor: ListAllMyBucketsResult.Owner


Container for response.

Type: Container

Children: Owner, Buckets

Ancestor: None


Bucket's name.

Type: String

Ancestor: ListAllMyBucketsResult.Buckets.Bucket


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.


Sample Request

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

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

Sample Response

<?xml version="1.0" encoding="UTF-8"?> <ListAllMyBucketsResult xmlns=""> <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>

Related Resources