Skip to main content

Set bucket lifecycle configuration

PUT 
/backend/api/object-storage/storage/:id/lifecycle

Host: https://core.ocplanet.cloud

Set or replace the lifecycle configuration for a bucket. Use this to automate retention and cleanup of stored objects.

Request​

Path Parameters

    id uuidrequired

    A UUID string identifying this Object Bucket.

Body

arrayrequired

Array of S3-compatible lifecycle rules. Pass an empty array to clear the configuration.

  • Array [
    • ID stringrequired

    Unique identifier of the rule within the bucket.

    Prefix string

    Object key prefix the rule applies to. Empty string means the rule applies to all objects.

    Status stringrequired

    Possible values: [Enabled, Disabled]

    Whether the rule is currently active.

    Expiration object

    Specifies when objects are deleted (current versions).

    Days integer

    Possible values: >= 1

    Number of days after object creation when the rule takes effect.

    Date date-time

    Specific date when the rule takes effect (ISO 8601).

    ExpiredObjectDeleteMarker boolean

    Whether to remove expired object delete markers.

    Transition object

    Defines when objects transition to a different storage class.

    Days integer
    Date date-time
    StorageClass stringrequired

    Possible values: [STANDARD, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE]

    NoncurrentVersionTransition object

    Defines when noncurrent object versions transition to a different storage class.

    NoncurrentDays integerrequired

    Possible values: >= 1

    StorageClass stringrequired

    Possible values: [STANDARD, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE]

    NoncurrentVersionExpiration object

    Defines when noncurrent object versions are permanently deleted.

    NoncurrentDays integerrequired

    Possible values: >= 1

    AbortIncompleteMultipartUpload object

    Aborts incomplete multipart uploads after the specified number of days.

    DaysAfterInitiation integerrequired

    Possible values: >= 1

  • ]

Responses​

Lifecycle configuration updated.

Schema
    Rules object[]
  • Array [
    • ID stringrequired

    Unique identifier of the rule within the bucket.

    Prefix string

    Object key prefix the rule applies to. Empty string means the rule applies to all objects.

    Status stringrequired

    Possible values: [Enabled, Disabled]

    Whether the rule is currently active.

    Expiration object

    Specifies when objects are deleted (current versions).

    Days integer

    Possible values: >= 1

    Number of days after object creation when the rule takes effect.

    Date date-time

    Specific date when the rule takes effect (ISO 8601).

    ExpiredObjectDeleteMarker boolean

    Whether to remove expired object delete markers.

    Transition object

    Defines when objects transition to a different storage class.

    Days integer
    Date date-time
    StorageClass stringrequired

    Possible values: [STANDARD, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE]

    NoncurrentVersionTransition object

    Defines when noncurrent object versions transition to a different storage class.

    NoncurrentDays integerrequired

    Possible values: >= 1

    StorageClass stringrequired

    Possible values: [STANDARD, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE]

    NoncurrentVersionExpiration object

    Defines when noncurrent object versions are permanently deleted.

    NoncurrentDays integerrequired

    Possible values: >= 1

    AbortIncompleteMultipartUpload object

    Aborts incomplete multipart uploads after the specified number of days.

    DaysAfterInitiation integerrequired

    Possible values: >= 1

  • ]
Loading...