The Wayback Machine - https://web.archive.org/web/20190822032006/https://docs.aws.amazon.com/AmazonS3/latest/API/RESTServiceGET.html
Sign In to the Console
Amazon Simple Storage Service
API Reference (API Version 2006-03-01)

AWS Documentation » Amazon Simple Storage Service (S3) » API Reference » Operations on the Service » GET Service

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.

Important

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
ID

Bucket owner's canonical 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>

Related Resources