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:signatureValue
Request Parameters
This implementation of the operation does not use request parameters.
Request Headers
This implementation of the operation only uses request headers common to all operations. For more information, see
Request Elements
This implementation of the operation does not use request elements.
Responses
Response Headers
This implementation of the operation uses only response headers that are common to most responses. For more information, see Common Response Headers.
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 2009 12:00:00 GMT Authorization: AWS 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE=
Sample Response
<?xml version="1.0" encoding="UTF-8"?> <ListAllMyBucketsResult xmlns="http://doc.s3.amazonaws.com/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>