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"
多少天后桶内容过期
使用 mc ilm add
和 --expiry-days
到
在对象创建数天后使存储桶内容过期:
mc ilm add ALIAS/PATH --expiry-days "DAYS"
列出存储桶生命周期管理规则
使用 :mc-command:`mc ilm list` 列出一个桶的生命周期管理规则:
mc ilm list ALIAS/PATH
删除存储桶生命周期管理规则
使用 mc ilm remove
删除存储桶生命周期管理规则:
mc ilm remove --id "RULE" ALIAS/PATH
语法
-
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” 存储桶。
一个或多个与号“&”分隔的键值对描述 应用生命周期配置规则的对象标签。
此选项与以下选项互斥:
-
--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。
-
-
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
-