Manage S3 lifecycle rules using the CLI

This page describes how to manage information lifecycle (ILM) rules for S3 buckets using the CLI.

Using the CLI, you can:

• Add a lifecycle rule

• View lifecycle rules

• Delete a lifecycle rule

• Reset the lifecycle rules of a bucket

Add a lifecycle rule

Command: weka s3 bucket lifecycle-rule add

Use the following command line to add a lifecycle rule:

weka s3 bucket lifecycle-rule add <bucket> <expiry-days> [--prefix prefix] [--tags tags]

Parameters

Name	Value
bucket*	Name of the S3 bucket.
expiry-days*	The minimum time to wait before expiring an object. In extreme load and scale cases, it might take longer than the set value in expiry-days to delete an object. Minimum: 1 day
prefix	Prefix of objects to apply the rule to.
tags	Key value pair of object tags to apply the rule to. Pairs of key values: '<k1>=<v1>&<k2=<v2>'

View lifecycle rules

Command: weka s3 bucket lifecycle-rule list‌

Use the following command line to view a bucket's existing lifecycle rules:‌

weka s3 bucket lifecycle-rule list <bucket>‌

Parameters

Name	Value	Default
bucket*	The name of the S3 bucket.	​Content

Remove a lifecycle rule

Command: weka s3 bucket lifecycle-rule remove

Use the following command line to remove an lifecycle rule of a specified bucket:

weka s3 bucket lifecycle-rule remove <bucket> <rule>

Parameters

Name	Value
bucket*	The name of the S3 bucket.
rule*	The ID of the rule to delete.

Remove all lifecycle rules

Command: weka s3 bucket lifecycle-rule reset

Use the following command line to remove all the lifecycle rules of a specified bucket:

weka s3 bucket lifecycle-rule reset <bucket>

Parameters

Name	Value
bucket*	The name of the S3 bucket.