Table of Contents
Each procedure on this page creates a new object lifecycle management rule that expires objects on a MinIO bucket. This procedure supports use cases like removing “old” objects after a certain time period or calendar date.
mc
This procedure uses mc
for performing operations on the MinIO cluster.
Install mc
on a machine with network access to both source and destination
clusters. See the mc
Installation Quickstart for
instructions on downloading and installing mc
.
Use the mc alias
command to create an alias for the source MinIO cluster
and the destination S3-compatible service. Alias creation requires specifying an
access key for a user on the source and destination clusters. The specified
users must have permissions for configuring
and applying expiry operations.
MinIO requires the following permissions scoped to the bucket or buckets for which you are creating lifecycle management rules.
MinIO also requires the following administrative permissions on the cluster in which you are creating remote tiers for object transition lifecycle management rules:
For example, the following policy provides permission for configuring object transition lifecycle management rules on any bucket in the cluster:.
{
"Version": "2012-10-17",
"Statement": [
{
"Action": [
"admin:SetTier",
"admin:ListTier"
],
"Effect": "Allow",
"Sid": "EnableRemoteTierManagement"
},
{
"Action": [
"s3:PutLifecycleConfiguration",
"s3:GetLifecycleConfiguration"
],
"Resource": [
"arn:aws:s3:::*"
],
"Effect": "Allow",
"Sid": "EnableLifecycleManagementRules"
}
]
}
Use mc ilm add
with --expiry-days
to
expire bucket contents a number of days after object creation:
mc ilm add ALIAS/PATH --expiry-days "DAYS"
Use mc ilm add
to expiring noncurrent object versions and object
delete markers:
To expire noncurrent object versions after a specific duration in days,
include --noncurrentversion-expiration-days
.
To expire delete markers for objects with no remaining versions,
include --expired-object-delete-marker
.
mc ilm add ALIAS/PATH \
--noncurrentversion-expiration-days NONCURRENT_DAYS \
--expired-object-delete-marker
Replace PATH
with the path to the bucket on the
S3-compatible host.
Replace NONCURRENT_DAYS
with the number of days after
which to expire noncurrent object versions. For example, specify 30d
to
expire a version after it has been noncurrent for at least 30 days.
This work is licensed under a Creative Commons Attribution 4.0 International License.
©2020-Present, MinIO, Inc.