Skip to main content

ListBuckets

Returns a list of all buckets owned by the authenticated sender of the request. To grant IAM permission to use this operation, you must add the s3:ListAllMyBuckets policy action.

Permissions​

ActionDescriptionResource
ListAllMyBucketsGrants permission to list all buckets owned by the authenticated sender of the request

Request Syntax​

GET / HTTP/1.1
Host: <partition>.s3.astran.io

URI Request Parameters​

The request does not have parameters.

Request Body​

The request does not have a request body.

Response Syntax​

HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult>
   <Buckets>
      <Bucket>
         <BucketRegion>string</BucketRegion>
         <CreationDate>timestamp</CreationDate>
         <Name>string</Name>
      </Bucket>
   </Buckets>
</ListAllMyBucketsResult>

Response Elements​

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in XML format by the service.

ListAllMyBucketsResult

Root level tag for the ListAllMyBucketsResult parameters.

Required: Yes

Buckets

The list of buckets owned by the requester.

Type: Array of Bucket data types

Examples​

Example 1: Unpaginated ListBuckets request​

GET / host:<partition>.s3.astran.io

HTTP/1.1 200 OK
<ListAllMyBucketsResult>
   <Buckets>
      <Bucket>
         <CreationDate>2019-12-11T23:32:47+00:00</CreationDate>
         <Name>amzn-s3-demo-bucket</Name>
      </Bucket>
      <Bucket>
         <CreationDate>2019-11-10T23:32:13+00:00</CreationDate>
         <Name>amzn-s3-demo-bucket1</Name>
      </Bucket>
   </Buckets>
</ListAllMyBucketsResult>

See Also​

For more information about using this API in one of the language-specific AWS SDKs, see the following: