listBuckets method
Written by
Updated at August 2, 2024
Returns a list of buckets available to the user.
Note
You can authorize in the Amazon S3 HTTP API and tools that support it using static keys obtained for the service account.
You can only view the list of buckets in the directory in which the service account you are using was created.
Request
GET / HTTP/2
Headers
Use only common request headers in your requests.
Response
Headers
Responses can only contain common response headers.
Response codes
For a list of possible responses, see Responses.
A successful response contains additional data in XML format with the schema described below.
Data schema
<ListAllMyBucketsResult>
<Buckets>
<Bucket>
<Name>bucket-name</Name>
<CreationDate>date_time</CreationDate>
</Bucket>
...
</Buckets>
</ListAllMyBucketsResult>
| Element | Description |
|---|---|
Bucket |
Contains a bucket description. Path: /ListAllMyBucketsResult/Buckets/Bucket. |
Buckets |
Contains a list of buckets. Path: /ListAllMyBucketsResult/Buckets. |
CreationDate |
Bucket creation time in the format yyyy-mm-ddThh:mm:ss.timezone.Path: /ListAllMyBucketsResult/Buckets/Bucket/CreationDate. |
ListAllMyBucketsResult |
Root element of a response. Path: /ListAllMyBucketsResult. |
Name |
Bucket name. Path: /ListAllMyBucketsResult/Buckets/Bucket/Name. |