Object lifecycles
Object lifecycles determine the retention period of objects uploaded to your bucket and allow you to specify when objects should transition from Standard storage to Infrequent Access storage.
A lifecycle configuration is a collection of lifecycle rules that define actions to apply to objects during their lifetime.
For example, you can create an object lifecycle rule to delete objects after 90 days, or you can set a rule to transition objects to Infrequent Access storage after 30 days.
- Objects will typically be removed from a bucket within 24 hours of the
x-amz-expirationvalue. - When a lifecycle configuration is applied that deletes objects, newly uploaded objects'
x-amz-expirationvalue immediately reflects the expiration based on the new rules, but existing objects may experience a delay. Most objects will be transitioned within 24 hours but may take longer depending on the number of objects in the bucket. While objects are being migrated, you may see old applied rules from the previous configuration. - An object is no longer billable once it has been deleted.
- Buckets have a default lifecycle rule to expire multipart uploads seven days after initiation.
- When an object is transitioned from Standard storage to Infrequent Access storage, a Class A operation is incurred.
When you create an object lifecycle rule, you can specify which prefix you would like it to apply to.
- Note that object lifecycles currently has a 1000 rule maximum.
- Managing object lifecycles is a bucket-level action, and requires an API token with the
Workers R2 Storage Writepermission group.
- From the Cloudflare dashboard, select R2.
- Locate and select your bucket from the list.
- From the bucket page, select Settings.
- Under Object lifecycle rules, select Add rule.
- Fill out the fields for the new rule.
- When you are done, select Add rule.
- Install
npm↗. - Install Wrangler, the Developer Platform CLI.
- Log in to Wrangler with the
wrangler logincommand. - Add a lifecycle rule to your bucket by running the
r2 bucket lifecycle addcommand.
npx wrangler r2 bucket lifecycle add <BUCKET_NAME> [OPTIONS]Alternatively you can set the entire lifecycle configuration for a bucket from a JSON file using the r2 bucket lifecycle set command.
npx wrangler r2 bucket lifecycle set <BUCKET_NAME> --file <FILE_PATH>The JSON file should be in the format of the request body of the put object lifecycle configuration API.
Below is an example of configuring a lifecycle configuration (a collection of lifecycle rules) with different sets of rules for different potential use cases.
const client = new S3({ endpoint: "https://4893d737c0b9e484dfc37ec392b5fa8a.r2.cloudflarestorage.com", credentials: { accessKeyId: "7dc27c125a22ad808cd01df8ec309d41", secretAccessKey: "1aa5c5b0c43defdb88f567487c071d17e234126133444770a706ae09336c57a4", }, region: "auto",});await client .putBucketLifecycleConfiguration({ Bucket: "testBucket", LifecycleConfiguration: { Rules: [ // Example: deleting objects on a specific date // Delete 2019 documents in 2024 { ID: "Delete 2019 Documents", Status: "Enabled", Filter: { Prefix: "2019/", }, Expiration: { Date: new Date("2024-01-01"), }, }, // Example: transitioning objects to Infrequent Access storage by age // Transition objects older than 30 days to Infrequent Access storage { ID: "Transition Objects To Infrequent Access", Status: "Enabled", Transitions: [ { Days: 30, StorageClass: "STANDARD_IA", }, ], }, // Example: deleting objects by age // Delete logs older than 90 days { ID: "Delete Old Logs", Status: "Enabled", Filter: { Prefix: "logs/", }, Expiration: { Days: 90, }, }, // Example: abort all incomplete multipart uploads after a week { ID: "Abort Incomplete Multipart Uploads", Status: "Enabled", AbortIncompleteMultipartUpload: { DaysAfterInitiation: 7, }, }, // Example: abort user multipart uploads after a day { ID: "Abort User Incomplete Multipart Uploads", Status: "Enabled", Filter: { Prefix: "useruploads/", }, AbortIncompleteMultipartUpload: { // For uploads matching the prefix, this rule will take precedence // over the one above due to its earlier expiration. DaysAfterInitiation: 1, }, }, ], }, }) .promise();To get the list of lifecycle rules associated with your bucket, run the r2 bucket lifecycle list command.
npx wrangler r2 bucket lifecycle list <BUCKET_NAME>import S3 from "aws-sdk/clients/s3.js";
// Configure the S3 client to talk to R2.const client = new S3({ endpoint: "https://4893d737c0b9e484dfc37ec392b5fa8a.r2.cloudflarestorage.com", credentials: { accessKeyId: "7dc27c125a22ad808cd01df8ec309d41", secretAccessKey: "1aa5c5b0c43defdb88f567487c071d17e234126133444770a706ae09336c57a4", }, region: "auto",});
// Get lifecycle configuration for bucketconsole.log( await client .getBucketLifecycleConfiguration({ Bucket: "bucketName", }) .promise(),);- From the Cloudflare dashboard, select R2.
- Locate and select your bucket from the list.
- From the bucket page, select Settings.
- Under Object lifecycle rules, select the rules you would like to delete.
- When you are done, select Delete rule(s).
To remove a specific lifecycle rule from your bucket, run the r2 bucket lifecycle remove command.
npx wrangler r2 bucket lifecycle remove <BUCKET_NAME> --id <RULE_ID>import S3 from "aws-sdk/clients/s3.js";
// Configure the S3 client to talk to R2.const client = new S3({ endpoint: "https://4893d737c0b9e484dfc37ec392b5fa8a.r2.cloudflarestorage.com", credentials: { accessKeyId: "7dc27c125a22ad808cd01df8ec309d41", secretAccessKey: "1aa5c5b0c43defdb88f567487c071d17e234126133444770a706ae09336c57a4", }, region: "auto",});
// Delete lifecycle configuration for bucketawait client .deleteBucketLifecycle({ Bucket: "bucketName", }) .promise();