Yandex Cloud
Search
Contact UsGet started
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • AI Studio
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
    • Yandex Cloud Partner program
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Yandex Object Storage
  • Pricing policy
  • Terraform reference
    • API authentication
      • How to use the API
      • Signing requests
      • Getting started with the S3 API
        • All services and methods
          • All methods
          • create
          • getBucketEncryption
          • getMeta
          • listObjects
          • listBuckets
          • deleteBucket
          • deleteBucketEncryption
          • putBucketEncryption
          • putBucketVersioning
          • getBucketVersioning
          • putBucketLogging
          • getBucketLogging
          • listObjectVersions
          • putObjectLockConfiguration
          • getObjectLockConfiguration
          • putBucketTagging
          • getBucketTagging
          • deleteBucketTagging
        • Common request headers
        • Common response headers
        • Responses
  • Monitoring metrics
  • Audit Trails events
  • Bucket logs
  • Release notes
  • FAQ

In this article:

  • Request
  • Headers
  • Response
  • Headers
  • Response codes
  • Data schema
  1. API reference
  2. REST (Amazon S3-compatible)
  3. REST
  4. Bucket
  5. listBuckets

listBuckets method

Written by
Yandex Cloud
Updated at June 11, 2025
  • Request
    • Headers
  • Response
    • Headers
    • Response codes
    • Data schema

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 folder in which your service account was created.

For more information on getting started with the API and the general request format, see How to use the S3 API.

RequestRequest

GET / HTTP/2

HeadersHeaders

Use only common headers in your requests.

ResponseResponse

HeadersHeaders

Responses can only contain common headers.

Response codesResponse codes

For a list of possible responses, see Responses.

A successful response contains additional data in XML format with the schema described below.

Data schemaData schema

<ListAllMyBucketsResult>
  <Buckets>
    <Bucket>
      <Name>bucket-name</Name>
      <CreationDate>date_time</CreationDate>
    </Bucket>
    ...
  </Buckets>
</ListAllMyBucketsResult>
Element Description
Bucket Contains the bucket description.

Path: /ListAllMyBucketsResult/Buckets/Bucket.
Buckets Contains the bucket list.

Path: /ListAllMyBucketsResult/Buckets.
CreationDate Bucket creation time in yyyy-mm-ddThh:mm:ss.timezone format.

Path: /ListAllMyBucketsResult/Buckets/Bucket/CreationDate.
ListAllMyBucketsResult Root element of the response.

Path: /ListAllMyBucketsResult.
Name Bucket name.

Path: /ListAllMyBucketsResult/Buckets/Bucket/Name.

See alsoSee also

  • Getting started with the AWS S3 API in Yandex Object Storage
  • Debugging requests using the AWS CLI
  • Example of sending a signed request using curl
  • Code example for generating a signature

Was the article helpful?

Previous
listObjects
Next
deleteBucket
© 2025 Direct Cursus Technology L.L.C.