Skip to content

Create Bucket

POST
/enum.api.v1.ObjectStorageBucketService/CreateObjectStorageBucket
object
projectId
string
name
string
regionId

Region for the bucket. When empty, the project’s default_region_id is used.

string
objectLockEnabled

Enable Object Lock at create time. Cannot be enabled after the bucket exists.

boolean
deletionProtected

Protect the bucket from deletion; it must be unprotected before it can be deleted. Defaults to true when omitted, so buckets are protected unless deletion protection is explicitly set to false.

boolean

OK

object
objectStorageBucket
object
id
string
projectId
string
name
string
createdBy
string
createdAt
string format: date-time
updatedAt
string format: date-time
status
string format: enum
Allowed values: RESOURCE_STATUS_UNSPECIFIED RESOURCE_STATUS_PROVISIONING RESOURCE_STATUS_READY RESOURCE_STATUS_FAILED RESOURCE_STATUS_DELETING
regionId

Region where the bucket lives (e.g. “fra”).

string
configuration

ObjectStorageBucketConfiguration is the current bucket configuration as reported by object storage. Documents are opaque XML or JSON strings in the same shape accepted by the corresponding Put RPCs.

object
versioning

Versioning status: Enabled, Suspended, or empty when unset.

string
objectLock

Object Lock configuration document (XML), empty when unset.

string
encryption

Default encryption configuration document (XML), empty when unset.

string
lifecycle

Lifecycle configuration document (XML), empty when unset.

string
cors

CORS configuration document (XML), empty when unset.

string
bucketPolicy

Bucket policy document (JSON), empty when unset.

string
tags

Bucket tags as a JSON object string, empty when unset.

string
objectLockEnabled

Whether Object Lock was enabled at create time. Cannot be changed later.

boolean
deletionProtected

When true, the bucket cannot be deleted until unprotected.

boolean