Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

put

Set or extend the WORM retention lock on an object

Usage

ionosctl object-storage object retention put [flags]

Aliases

For object command:

[obj]

For retention command:

[ret]

For put command:

[p]

Description

Place an Object Lock retention lock on an object, protecting it from deletion and overwrite until --retain-until-date.

--mode selects how strict the lock is: GOVERNANCE can be overridden by users with the bypass permission, COMPLIANCE can never be overridden before the date (see the "retention" group help).

The retain-until date is always in the future. You can freely EXTEND an existing lock (set a later date) in either mode. SHORTENING or removing a lock is only possible for GOVERNANCE mode and requires --bypass-governance-retention plus the bypass permission; COMPLIANCE-mode dates can never be reduced.

Requires a bucket created with Object Lock enabled - it cannot be turned on for an existing bucket. On versioned buckets, pass --version-id to lock a specific version.

Options

Examples

Last updated