Manage S3 life cycle configuration

Life cycle configurations automatically expire or delete objects in a bucket based on their age or prefix. Each life cycle configuration applies to one bucket and can contain up to 1000 rules.

Prerequisites

• Object Storage enabled and credentials configured: Enable Object Storage
• AWS CLI installed and configured for STACKIT Object Storage: Set up the AWS CLI

Life cycle rule structure

Each life cycle rule can include:

Element	Description
ID	A unique identifier within the life cycle configuration.
Filter	Filters objects by prefix, tag, or both (combined with logical AND).
Expiration	Expires objects after a specific date or number of days since upload.
NonCurrentVersionExpiration	Same as Expiration, but applies only to non-current versions in versioned buckets. When versioning is enabled and a file is deleted, it becomes a non-current version with a delete marker inserted as the current version. This element permanently removes those non-current versions.
Status	Enabled or Disabled. Disabled rules are inactive and no actions are performed.

When an expiration condition is met, the object is not deleted immediately. Deletion routines remove expired objects within approximately 10 days.

Examples

Filter by prefix

The following rule expires all objects with the prefix backups/ that were uploaded more than 10 days ago:

{
  "Rules": [
    {
      "ID": "delete-all-objects-after-ten-days",
      "Filter": {
        "Prefix": "backups/"
      },
      "Status": "Enabled",
      "Expiration": {
        "Days": 10
      }
    }
  ]
}

Combined prefix and tag filter

The following rule expires objects with the prefix backups/ and the tag key1=value1 after 10 days:

{
  "Rules": [
    {
      "ID": "delete-all-backup-objects-key1-value1-after-ten-days",
      "Filter": {
        "And": {
          "Prefix": "backups/",
          "Tags": [
            {
              "Key": "key1",
              "Value": "value1"
            }
          ]
        }
      },
      "Status": "Enabled",
      "Expiration": {
        "Days": 10
      }
    }
  ]
}

Create a life cycle policy

1. Create a life cycle policy file in JSON format, for example lifecycle_policy.json:

   {
     "Rules": [
       {
         "ID": "my-rule-id",
         "Filter": {
           "Prefix": "my-prefix/"
         },
         "Status": "Enabled",
         "Expiration": {
           "Days": 99
         }
       }
     ]
   }

2. Apply the policy to your bucket:

   aws s3api put-bucket-lifecycle-configuration \
     --bucket my-example-bucket \
     --lifecycle-configuration file://lifecycle_policy.json \
     --endpoint-url https://object.storage.eu01.onstackit.cloud

Get the life cycle policy of a bucket

aws s3api get-bucket-lifecycle-configuration \
  --bucket my-example-bucket \
  --endpoint-url https://object.storage.eu01.onstackit.cloud

Delete a life cycle policy

aws s3api delete-bucket-lifecycle \
  --bucket my-example-bucket \
  --endpoint-url https://object.storage.eu01.onstackit.cloud