欢迎来到即将发布的 MinIO 文档版本！此页面上的内容正在积极开发中可能随时更改。如果找不到您要找的内容，请查看我们的历史文档。感谢您的耐心等待。 我们期待您贡献自己强大的力量，帮助更多的中国技术开发者！[翻译]

`mc ilm`

Table of Contents

描述
- 生命周期管理对象扫描器
- 到期与过渡
例子
语法

描述

mc ilm 命令管理对象生命周期管理桶上的规则。请参阅 AWS 文档 Object Lifecycle Management 想要查询更多的信息。

生命周期管理对象扫描器

MinIO 使用扫描器进程根据所有已配置的对象检查对象生命周期管理规则。由于高 IO 工作负载或有限的系统资源可能会延迟生命周期管理的应用规则。看生命周期管理对象扫描器想要查询更多的信息。

到期与过渡

MinIO 支持在同一个文件中同时指定到期和转换规则桶或桶前缀。 MinIO 可以对对象执行过期规则无论其过渡状态如何。用 mc ilm list 查看当前配置的对象生命周期到期和转换规则之间任何潜在交互的管理规则。

例子

在特定日期后使存储桶内容过期

使用 mc ilm add 和 --expiry-date 到在特定日期后使存储桶内容过期。

mc ilm add ALIAS/PATH --expiry-date "DATE"

将 ALIAS 替换为 S3 兼容主机的 alias。
将 PATH 替换为存储桶的路径 S3 兼容主机。
将 DATE 替换为之后的日历日期哪个对象过期。例如指定“2021-01-01”过期 2021 年 1 月 1 日之后的对象。

多少天后桶内容过期

使用 mc ilm add 和 --expiry-days 到在对象创建数天后使存储桶内容过期:

mc ilm add ALIAS/PATH --expiry-days "DAYS"

将 ALIAS 替换为 S3 兼容主机的 alias。
将 PATH 替换为存储桶的路径 S3 兼容主机。
将 DATE 替换为之后的天数哪个对象过期。例如，指定 30d 使对象创建后 30 天。

列出存储桶生命周期管理规则

使用 :mc-command:`mc ilm list` 列出一个桶的生命周期管理规则:

mc ilm list ALIAS/PATH

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

删除存储桶生命周期管理规则

使用 mc ilm remove 删除存储桶生命周期管理规则:

mc ilm remove --id "RULE" ALIAS/PATH

将 RULE 替换为生命周期的唯一名称管理规则。
将 ALIAS 替换为 S3 兼容主机的 alias。
将 PATH 替换为指向存储桶的路径 S3 兼容主机。

语法

mc ilm list

列出指定桶的当前生命周期管理规则。该子命令具有以下语法:

mc ilm list TARGET [FLAGS]

该子命令支持以下参数:

TARGET

Required 列出现有存储桶的完整路径生命周期管理规则。指定 alias 配置的 S3 服务作为 TARGET 路径的前缀。

例如:

mc ilm list play/mybucket

--expiry: mc ilm 仅返回与生命周期规则到期相关的字段。

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

--minimum

mc ilm 仅返回以下字段:

id
prefix
status
transition set
expiry set

mc ilm add

添加新的存储桶生命周期管理规则。该命令有以下语法:

mc ilm add TARGET [FLAGS]

TARGET

Required

要从中添加生命周期的存储桶的完整路径管理规则。指定已配置 S3 的 alias service 作为 TARGET 路径的前缀。

例如:

mc ilm add play/mybucket [FLAGS]

--prefix

TARGET 存储桶的特定子集的路径: 应用生命周期配置规则。 MinIO 附加 --prefix 字段添加到 TARGET 路径构建完整路径。

省略将规则应用于整个 “TARGET” 存储桶。

--tags

一个或多个与号“&”分隔的键值对描述应用生命周期配置规则的对象标签。

此选项与以下选项互斥:

--expired-object-delete-marker

--expiry-date

MinIO 保留对象的 ISO-8601 格式的日历日期创建后。 MinIO 将对象标记为删除，一旦系统主机日期时间通过该日历日期。

指定当前系统主机 prior 的日历日期 datetime 将规则涵盖的所有对象标记为删除。

对于版本化存储桶，到期规则仅适用于 current 对象版本。使用 --noncurrentversion-expiration-days 将过期行为应用于非当前对象版本的选项。

MinIO 使用扫描器进程根据所有已配置的对象检查对象生命周期管理规则。由于高 IO 工作负载或有限的系统资源可能会延迟生命周期管理的应用规则。有关更多信息，请参阅：ref:minio-lifecycle-management-scanner。

--expiry-days

创建对象后保留的天数。 MinIO 在经过指定的天数后标记要删除的对象。

对于版本化存储桶，到期规则仅适用于 current 对象版本。使用 --noncurrentversion-expiration-days 将过期行为应用于非当前对象版本的选项。

noncurrentversion-expiration-days
:option:: 成为对象版本后保留的天数 non-current （即该对象的不同版本现在是`HEAD`）。 MinIO 将非当前对象版本标记为在经过指定天数后删除。

此选项具有与 S3 NoncurrentVersionExpiration 操作相同的行为。

MinIO 使用扫描器进程根据所有已配置的对象检查对象生命周期管理规则。由于高 IO 工作负载或有限的系统资源可能会延迟生命周期管理的应用规则。有关更多信息，请参阅：ref:minio-lifecycle-management-scanner。

--expired-object-delete-marker

指定 true 以指示 MinIO 删除没有剩余对象版本的对象的删除标记。具体来说，删除标记是给定对象的 only 剩余 “version” 。

默认为 false.

此选项与以下选项互斥:

--tags

--transition-date

ISO-8601 格式的日历日期，在此日期之后 MinIO 将对象标记为有资格转换到远程层。 MinIO 将对象转换到指定给 --storage-class 一旦系统主机日期时间超过该日历日期。

对于版本化存储桶，转换规则仅适用于 current 对象版本。使用 --noncurrentversion-transition-days 将转换行为应用于非当前对象版本的选项。

--transition-days

从对象创建开始的日历天数，在此之后 MinIO 将对象标记为符合转换条件。 MinIO 将对象转换到指定给 --storage-class.

对于版本化存储桶，转换规则仅适用于 current 对象版本。使用 --noncurrentversion-transition-days 将转换行为应用于非当前对象版本的选项。

--noncurrentversion-transition-days

在 MinIO 将对象版本标记为符合转换条件之前，对象已非当前（即被同一对象的较新版本替换）的天数。 MinIO 将对象转换到指定给 --storage-class 一旦系统主机日期时间超过该日历日期。

此选项对非版本化存储桶没有影响。

此选项具有与 S3 NoncurrentVersionTransition 操作相同的行为。

--storage-class

MinIO 连接到的远程存储层 transition objects. 指定创建的远程存储层 mc admin tier.

如果对 Amazon S3 服务使用 mc ilm add，则此参数是用于转换规则涵盖的对象的 Amazon S3 存储类。有关 S3 存储类的更多信息，请参阅 Transition objects using Amazon S3 Lifecycle。

--disable: 禁用规则。

mc ilm edit

编辑存储桶中的现有生命周期管理规则。该命令具有以下语法:

mc ilm edit --id "RULE_ID" TARGET [FLAGS]

该命令支持以下参数:

TARGET

Required

要从中修改指定生命周期管理规则的存储桶的完整路径。将配置的 S3 服务的 alias 指定为 TARGET 路径的前缀。

例如:

mc ilm edit --id "RULE_ID" play/mybucket [FLAGS]

--id

Required

规则的唯一 ID。使用 :mc-command:`mc ilm list` 列出存储桶规则并检索要修改的规则的 “id”。

mc ilm remove

从存储桶中删除现有的生命周期管理规则。该命令具有以下语法:

 mc ilm remove [FLAGS] TARGET

该命令支持以下参数:

TARGET

Required 要从中删除指定生命周期管理规则的存储桶的完整路径。将配置的 S3 服务的 alias 指定为 TARGET 路径的前缀。

例如:

mc ilm remove [FLAGS] play/mybucket

id

Required

规则的唯一 ID。使用 mc ilm list 列出存储桶规则并检索要删除的规则的 “id”。

与 mc ilm remove --all 互斥。

all

Required 删除存储桶中的所有规则。与 :mc-command-option:`mc ilm remove id` 互斥。

需要包括 --force.

force: 指定时需要 --all.

mc ilm export

将 JSON 格式的生命周期配置导出到 “STDOUT”。该命令具有以下语法:

mc ilm export TARGET

该命令支持以下参数:

TARGET

Required 要从中导出配置的生命周期管理规则的存储桶的完整路径。将配置的 S3 服务的 alias 指定为 TARGET 路径的前缀。例如:

mc ilm export play/mybucket > play_mybucket_lifecycle_rules.json

mc ilm import

从“STDIN”导入 JSON 格式的生命周期配置。该命令具有以下语法:

mc ilm import TARGET

该命令支持以下参数:

TARGET

Required 应用导入的生命周期管理规则的存储桶的完整路径。将配置的 S3 服务的 alias 指定为 TARGET 路径的前缀。例如:

mc ilm import play/mybucket < play_mybucket_lifecycle_rules.json