CubePathDOCS

Object Storage

Create bucket

post/object-storage/buckets

Create an S3 compatible bucket in the storage tier you choose. It is ready in a few seconds and is billed by the hour for what it stores, serves and the requests it receives.

Autorización

Authorization
Authorization*string

Bearer YOUR_API_TOKEN con un token de API. También vale la cabecera X-API-Key: YOUR_API_TOKEN.

Cuerpo de la petición

Create a bucket.

application/jsonObligatorio
name*string

Globally unique bucket name

Rangolength ≤ 255
tier*string

Tier slug or uuid

Rangolength ≤ 64
project_id?integer | null

Project (default: the organization's first project)

versioning?boolean

Create the bucket with versioning enabled

Por defectofalse
tags?record<string, string> | null

Labels {key: value}, at most 50

lifecycle_rules?array<ObjectStorageLifecycleRule> | null

Lifecycle rules applied when the bucket is created (same as PUT .../lifecycle)

Rangoitems ≤ 1000
Propiedades (8)
id*string
Rangolength ≤ 255
enabled?boolean
Por defectotrue
filter?ObjectStorageLifecycleFilter | null
Propiedades (4)
prefix?string | null
Rangolength ≤ 4096
tags?array<ObjectStorageLifecycleTag> | null
Rangoitems ≤ 50
Propiedades (2)
key*string
Rangolength ≤ 512
value*string
Rangolength ≤ 512
object_size_greater_than?integer | null
object_size_less_than?integer | null
expiration?ObjectStorageLifecycleExpiration | null
Propiedades (3)
days?integer | null

Days after the object was written

date?string | null

YYYY-MM-DD (midnight UTC), after today

expired_object_delete_marker?boolean | null

Remove delete markers left without any version (versioned buckets)

noncurrent_version_expiration?ObjectStorageLifecycleNoncurrent | null
Propiedades (2)
noncurrent_days*integer

Days after a version stopped being the current one

newer_noncurrent_versions?integer | null

Keep this many newer versions

abort_incomplete_multipart_upload?ObjectStorageLifecycleAbort | null
Propiedades (1)
days_after_initiation*integer
transitions?any

Not supported

noncurrent_version_transitions?any

Not supported

object_lock?boolean

Create the bucket with Object Lock (WORM). Only possible now, never later; implies versioning

Por defectofalse
object_lock_default?ObjectStorageLockRetention | null

Default retention of new objects (only with object_lock); null for none

Propiedades (3)
mode*string

governance: keys with the bypass permission can still delete; compliance: nobody can

Valores"governance""compliance"
days?integer | null

Retention in days

years?integer | null

Retention in years

accept_object_lock_terms?boolean

Required (true) with object_lock: you accept the Object Lock terms

Por defectofalse

Respuestas

Successful Response

application/json

detail*string
uuid*string
name*string
status*string
project_id?integer | null
tier*ObjectStorageTierSummary
Propiedades (4)
uuid*string
slug*string
name*string
media*string
region*string
endpoint*string
tags?record<string, string>
Por defecto{}
object_lock*ObjectStorageObjectLockOut
Propiedades (2)
enabled*boolean
default_retention?ObjectStorageLockRetentionOut | null
Propiedades (3)
mode*string
Valores"governance""compliance"
days?integer | null
years?integer | null