minio/docs
1
0
Fork 0
mirror of https://github.com/minio/docs.git synced 2025-07-28 19:42:10 +03:00
Code Activity
Files
rename
docs/source/reference/minio-mc/mc-ilm-rule.rst
Daryl White 00de8dbeb6 Updates to mc docs for December 2022 releases (#697) 
This PR applies updates to numerous files to address changes in the two
December 2022 `mc` releases.

- Deprecates `mc admin bucket quota` and links to new commands
- Adds `mc quota set | clear | info` commands
- Adds `attach | detach` subcommands to `mc admin idp ldap policy`
- Updates list of call types available to `mc admin trace`
- Updates `mc` page with new commands
- Fixes minor errors in `mc cp`
- Adds `--limit-*` flags to global flag options
- Adds `--versions` flag to `mc find`
    
Closes #685

- Updates ilm commands for new structure for tiers and rules
    
    - Deprecates `mc admin tier`
- Deprecates `mc ilm add | edit | export | import | ls | rm` commands
    - Adds new `mc ilm rule` and six subcommands
    - Adds new `mc ilm tier` and six subcommands
    - Updates references to ilm and admin tier  commands throughout docs
    - Adds new deprecated commands page
    - Adds `mc ilm rule` and `mc ilm tier` holding pages with toctrees

- Closes #691
- Closes #662
2023-01-10 15:47:02 -06:00

4.2 KiB
Raw Permalink Blame History

mc ilm rule

minio

Table of Contents

mc ilm rule

RELEASE.2022-12-24T15-21-38Z

The following commands have moved to subcommands under mc ilm rule:

  • mc ilm add
  • mc ilm edit
  • mc ilm export
  • mc ilm import
  • mc ilm ls
  • mc ilm rm

Description

The mc ilm rule command and its subcommands configure the rules used to transition objects between storage tiers in MinIO's Lifecycle Management.

Before creating rules with this command, use mc ilm tier and its subcommands to create the tier or tiers of other object storage locations where objects move.

For more information, see the overview of lifecycle management <minio-lifecycle-management>.

Subcommands

mc ilm rule includes the following subcommands:

Subcommand Description
~mc ilm rule add
~mc ilm rule edit
~mc ilm rule export
~mc ilm rule import
~mc ilm rule ls
~mc ilm rule rm

Permissions

MinIO requires the following permissions scoped to to the bucket or buckets for which you create lifecycle management rules.

  • s3:PutLifecycleConfiguration
  • s3:GetLifecycleConfiguration

For example, the following policy provides permission for configuring object transition lifecycle management rules on any bucket in the cluster:.

/extra/examples/LifecycleManagementAdmin.json

Transition Permissions

Object transition lifecycle management rules require additional permissions on the remote storage tier. Specifically, MinIO requires the remote tier credentials provide read, write, list, and delete permissions.

For example, if the remote storage tier implements AWS IAM policy-based access control, the following policy provides the necessary permission for transitioning objects into and out of the remote tier:

/extra/examples/LifecycleManagementUser.json

Modify the Resource for the bucket into which MinIO tiers objects.

Defer to the documentation for the supported tiering targets for more complete information on configuring users and permissions to support MinIO tiering:

/reference/minio-mc/mc-ilm-rule-add /reference/minio-mc/mc-ilm-rule-edit /reference/minio-mc/mc-ilm-rule-export /reference/minio-mc/mc-ilm-rule-import /reference/minio-mc/mc-ilm-rule-ls /reference/minio-mc/mc-ilm-rule-rm