Yandex Cloud
Documentation
PresentationContact UsTry it for free
© 2026 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
          • CreateBucket
          • GetBucketEncryption
          • HeadBucket
          • 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. AWS S3 REST
  3. REST
  4. Bucket
  5. ListBuckets

Object Storage API, Amazon S3-compatible REST: ListBuckets

Written by
Yandex Cloud
Updated at August 20, 2026
View in Markdown
  • 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.

Related articlesRelated articles

  • Bucket in Object Storage

  • Getting a list of buckets

Useful linksUseful links

  • 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
© 2026 Direct Cursus Technology L.L.C.