v32

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

S3-Compatible Storage

Create bucket

Creates a new bucket within an S3-compatible storage.

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

Path parameters

storage_idinteger required

Storage ID

Request body

namestring required

Name of the bucket to create

Example request

{
  "name": "my-new-bucket"
}

Response

BucketDetailResV4

namestring required

Globally unique bucket name within the storage. Used as the path prefix when accessing objects via S3 API.

storage_idinteger required

Parent storage this bucket belongs to. Use this ID in the URL path for bucket operations.

Example response

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