`mc ilm rule ls`

在 RELEASE.2022-12-24T15-21-38Z 版本发生变更: mc ilm rule ls 取代了 mc ilm ls .

在 RELEASE.2023-05-26T23-31-54Z 版本发生变更: mc ilm rule ls --json 输出的内容包括策略修改时间在 updateAt 中。

语法

mc ilm rule ls 命令以表格格式总结了MinIO桶上配置的所有对象生命周期管理规则。

mc ilm rule list 命令与 mc ilm rule ls 命令具有相同的功能。

EXAMPLE

以下命令列出了在 myminio MinIO部署上的 mydata 桶中配置的所有生命周期管理规则：

mc ilm rule ls myminio/mydata

命令的输出可能如下所示：

┌───────────────────────────────────────────────────────────────────────────────┐
│ Transition for latest version (Transition)                                    │
├────────┬─────────┬────────┬─────────────────────┬──────────────┬──────────────┤
│ ID     │ STATUS  │ PREFIX │ TAGS                │ DAYS TO TIER │ TIER         │
├────────┼─────────┼────────┼─────────────────────┼──────────────┼──────────────┤
│ rule-1 │ Enabled │ doc/   │ key1=val1&key2=val2 │            0 │ WARM-MINIO-1 │
└────────┴─────────┴────────┴─────────────────────┴──────────────┴──────────────┘
┌────────────────────────────────────────────────────────────────┐
│ Transition for older versions (NoncurrentVersionTransition)    │
├────────┬─────────┬────────┬──────┬──────────────┬──────────────┤
│ ID     │ STATUS  │ PREFIX │ TAGS │ DAYS TO TIER │ TIER         │
├────────┼─────────┼────────┼──────┼──────────────┼──────────────┤
│ rule-2 │ Enabled │ logs/  │ -    │           10 │ WARM-MINIO-1 │
└────────┴─────────┴────────┴──────┴──────────────┴──────────────┘
┌────────────────────────────────────────────────────────────────────────────────────────┐
│ Expiration for latest version (Expiration)                                             │
├────────┬─────────┬────────┬─────────────────────┬────────────────┬─────────────────────┤
│ ID     │ STATUS  │ PREFIX │ TAGS                │ DAYS TO EXPIRE │ EXPIRE DELETEMARKER │
├────────┼─────────┼────────┼─────────────────────┼────────────────┼─────────────────────┤
│ rule-1 │ Enabled │ doc/   │ key1=val1&key2=val2 │             30 │ false               │
└────────┴─────────┴────────┴─────────────────────┴────────────────┴─────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────────┐
│ Expiration for older versions (NoncurrentVersionExpiration)                      │
├────────┬─────────┬────────┬─────────────────────┬────────────────┬───────────────┤
│ ID     │ STATUS  │ PREFIX │ TAGS                │ DAYS TO EXPIRE │ KEEP VERSIONS │
├────────┼─────────┼────────┼─────────────────────┼────────────────┼───────────────┤
│ rule-1 │ Enabled │ doc/   │ key1=val1&key2=val2 │             15 │             0 │
│ rule-2 │ Enabled │ logs/  │ -                   │              1 │             3 │
└────────┴─────────┴────────┴─────────────────────┴────────────────┴───────────────┘

SYNTAX

mc ilm rule ls 命令具有以下语法：

mc [GLOBALFLAGS] ilm rule ls     \
                 [--expiry]      \
                 [--transition]

方括号 [] 表示可选参数。
参数在同一行表示它们是相互依赖的。
使用管道 | 运算符分隔的参数是相互排斥的。

在终端/壳中运行命令之前，将示例复制到文本编辑器中并按需进行修改。

参数

ALIAS

Required

alias 和MinIO部署上存储桶的完整路径，用于列出对象生命周期管理规则。例如：

mc ilm rule ls myminio/mydata

--expiry

Optional

mc ilm rule ls 命令只返回与生命周期规则过期相关的字段。

与 --transition 相互排斥。

--transition

Optional

mc ilm rule ls 仅返回与生命周期规则转换相关的字段。

与 --expiry 相互排斥。

全局标记

此命令支持任何全局标志。

示例

列出桶生命周期管理规则

使用 mc ilm rule ls 列出存储桶的生命周期管理规则：

mc ilm rule ls ALIAS/PATH

将 ALIAS 替换为 S3 兼容主机的 alias。
将 PATH 替换为在 S3 兼容主机上的桶的路径。

显示策略修改时间。

使用 mc ilm rule ls 命令并结合 --json 选项来显示一个存储桶策略的最后更新时间。

mc ilm rule ls ALIAS/PATH --json

将 ALIAS 替换为 S3 兼容主机的 alias。
将 PATH 替换为在 S3 兼容主机上的桶的路径。

JSON输出中的 updateAt 属性包含了策略更新的日期和时间。

输出类似于以下内容：

{
 "status": "success",
 "target": "myminio/mybucket",
 "config": {
  "Rules": [
   {
    "Expiration": {
     "Days": 30
    },
    "ID": "ci1o2mg0sko6f1r3krv0",
    "Status": "Enabled"
   }
  ]
 },
 "updatedAt": "2023-06-09T19:45:30Z"
}

所需权限

有关列出规则所需的权限，请参考父命令的所需权限。

行为

S3兼容性

mc 命令行工具是为了与 AWS S3 API 兼容而构建的，并且已经过测试，以确保在与 MinIO 和 AWS S3 配合使用时，功能和行为符合预期。

MinIO 不对其他 S3 兼容服务提供任何保证，因为它们的 S3 API 实现是未知的，因此不受支持。尽管 mc 命令可能如文档中所述工作，但任何此类使用都是您自己的风险。

商业支持购买咨询