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

mc ilm

描述

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

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

此选项与以下选项互斥:

--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 将过期行为应用于非当前对象版本的选项。

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

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.

此选项与以下选项互斥:

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

--transition-date

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

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

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

--transition-days

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

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

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

--noncurrentversion-transition-days

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

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

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

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

--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