v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
S3-Compatible Storage

List buckets

Returns a paginated list of buckets for an S3-compatible storage, including each bucket's CORS, Lifecycle, and Policy configuration. Results are sorted alphabetically by bucket name (ascending).

get/storage/v4/object_storages/{storage_id}/buckets

Path parameters

storage_idinteger required

Storage ID

Query parameters

offsetinteger

Number of records to skip before beginning to return results

limitinteger

Max number of records in response

Response

BucketListEndpointResV4

countinteger required

Total number of buckets

Example response

{
  "count": 5,
  "results": [
    {
      "cors": {
        "allowed_origins": [
          "https://example.com",
          "*"
        ]
      },
      "lifecycle": {
        "expiration_days": 30
      },
      "name": "my-bucket",
      "policy": {
        "is_public": true
      },
      "storage_id": 123
    }
  ]
}