`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 中的策略修改时间。

语法

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

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

示例

以下命令列出 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 │
└────────┴─────────┴────────┴─────────────────────┴────────────────┴───────────────┘

语法

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

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

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

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

参数

ALIAS

必需的

The alias 以及要列出对象生命周期管理规则的 MinIO 部署上的存储桶的完整路径。例如

mc ilm rule ls myminio/mydata

--expiry

可选的

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

与 --transition 相互排斥。

--transition

可选的

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 兼容性

The mc 命令行工具是为了与 AWS S3 API 兼容而构建的，并已在 MinIO 和 AWS S3 上进行了测试，以确保预期功能和行为。

MinIO 不会对其他与 S3 兼容的服务提供任何保证，因为它们的 S3 API 实现是未知的，因此不受支持。虽然 mc 命令可能按文档工作，但任何此类使用均由您自行承担风险。