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
4.0 KiB
mc ilm tier
minio
Table of Contents
mc ilm tier
RELEASE.2022-12-24T15-21-38Z
mc ilm tier
replaces mc admin tier
.
Description
The mc ilm tier
command and its subcommands configure a remote supported S3-compatible
service for MinIO Lifecycle Management: Object Transition ("Tiering") <minio-lifecycle-management-expiration>
.
After creating one or more tiers with this command, use mc ilm rule
and its
subcommands to create the rules that move objects to other storage.
For more information, see the overview of lifecycle management <minio-lifecycle-management>
.
Subcommands
mc ilm tier
includes the following subcommands:
Subcommand | Description |
---|---|
~mc ilm tier add |
|
~mc ilm tier check |
|
~mc ilm tier info |
|
~mc ilm tier ls |
|
~mc ilm tier rm |
|
~mc ilm tier update |
Required Permissions
To create tiers for object transition, MinIO requires the following administrative permissions on the cluster:
admin:SetTier
admin:ListTier
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:
Amazon S3 Permissions <service-authorization/latest/reference/list_amazons3.html#amazons3-actions-as-permissions>
- Google Cloud Storage Access Control
- Authorizing access to data in Azure storage
/reference/minio-mc/mc-ilm-tier-add /reference/minio-mc/mc-ilm-tier-check /reference/minio-mc/mc-ilm-tier-info /reference/minio-mc/mc-ilm-tier-ls /reference/minio-mc/mc-ilm-tier-rm /reference/minio-mc/mc-ilm-tier-update