CubePathDOCS

Object Storage

Set bucket default retention

put/object-storage/buckets/{bucket_uuid}/object-lock

Change or remove the default retention of a bucket created with Object Lock. It applies to the objects without a retention of their own; lowering or removing it never frees what is already written under compliance. A compliance default retention can only be kept or lengthened.

Authorization

Authorization
Authorization*string

Bearer YOUR_API_TOKEN with an API token. The X-API-Key: YOUR_API_TOKEN header works too.

Path parameters

bucket_uuid*string

Request body

Change or remove the default retention of a bucket with Object Lock.

application/jsonRequired
default_retention*ObjectStorageLockRetention | null

The new default retention, or null to remove it

Properties (3)
mode*string

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

Value in"governance""compliance"
days?integer | null

Retention in days

years?integer | null

Retention in years

accept_object_lock_terms?boolean

Required (true) when the change turns compliance on or lengthens the retention

Defaultfalse

Responses

Successful Response

application/json

detail*string