mc rm

参数

ALIAS

Required

MinIO 部署的 alias，以及要删除对象的完整路径。 例如：

mc rm play/mybucket/object.txt

你可以在同一个或不同的 MinIO 部署上指定多个对象。 例如：

mc rm play/mybucket/object.txt play/mybucket/otherobject.txt

如果指定的是存储桶或存储桶前缀路径，必须 同时 指定 --recursive 和 --force 参数。例如：

mc rm --recursive --force play/mybucket/

mc rm --recursive --force play/mybucket/myprefix/

建议先使用 --dry-run 标志运行命令，验证 递归删除操作的范围。

若要从本地文件系统删除文件，请指定该文件的完整路径：

mc rm ~/data/myoldobject.txt

--bypass

Optional

允许删除受 GOVERNANCE 对象锁保护的对象。

--dangerous

Optional

当 ALIAS 指定 MinIO 部署的根路径（所有存储桶）时， 允许执行 mc rm。

与 --versions 结合使用时， 此标志会指示 mc rm 永久删除 ALIAS 目标中的所有对象 以及 所有版本。

建议先使用 --dry-run 运行命令， 验证站点范围删除操作的范围。

Warning

搭配 --versions 标志运行 mc rm --dangerous 是不可逆操作。执行前请尽可能 审慎核查，确保命令只应用于预期的 ALIAS 目标。

--dry-run

Optional

输出命令结果，但不会实际删除任何文件。 使用此标志可测试命令配置是否仅删除你希望删除的对象。

--force

Optional

允许 mc rm 与以下任一参数一起运行：

• --recursive

• --versions

• --stdin

--incomplete, I

Optional

删除指定对象的不完整上传。

如果任一 ALIAS 指定了存储桶， 则 必须 同时指定 --recursive 和 --force。

--newer-than

Optional

删除新于指定时长的对象。请使用 #d#hh#mm#ss 格式的字符串。例如：--newer-than 1d2hh3mm4ss

默认为 ``0``（所有对象）。

--non-current

Optional

从指定的 ALIAS 中删除所有 非当前 对象版本。

对未启用 版本控制 的存储桶，此选项无效。

--older-than

Optional

删除早于指定时间限制的对象。请使用 #d#h#m#s 格式的字符串。例如：--older-than 1d2h3m4s。

默认为 ``0``（所有对象）。

--recursive, r

Optional

递归删除每个 ALIAS 存储桶或存储桶前缀的内容。

如果指定 --recursive，则 必须 同时 指定 --force。

对启用了 版本控制 的存储桶， 此选项默认会为每个被删除对象生成一个删除标记。 添加 --versions 标志可递归删除存储桶中的 所有对象 以及 对象版本。

建议先使用 --dry-run 标志运行命令，验证 递归删除操作的范围。

与 mc rm --version-id 互斥

--rewind

Optional

指示 mc rm 仅对指定时间点存在的对象版本执行操作。

• 如需回溯到过去的特定日期，请将该日期指定为 ISO8601 格式的时间戳。 例如：--rewind "2020.03.24T10:00"。

• 如需按时间长度回溯，请将该时长指定为 #d#hh#mm#ss 格式的字符串。 例如：--rewind "1d2hh3mm4ss"。

--rewind 要求指定的 ALIAS 指向支持 存储桶版本控制 的 S3 兼容服务。对于 MinIO 部署， 请使用 mc version 启用或禁用存储桶版本控制。

--stdin

Optional

从 STDIN 读取对象名称或存储桶。

--versions

Optional

指示 mc rm 对存储桶中存在的所有对象版本执行操作。

--versions 要求指定的 ALIAS 指向支持 存储桶版本控制 的 S3 兼容服务。对于 MinIO 部署， 请使用 mc version 启用或禁用存储桶版本控制。

将 --versions 与 --rewind 一起使用，可删除某一特定时间点 存在的对象的所有版本。

--version-id, vid

Optional

指示 mc rm 仅对指定的对象版本执行操作。

--version-id 要求指定的 ALIAS 指向支持 存储桶版本控制 的 S3 兼容服务。对于 MinIO 部署， 请使用 mc version 启用或禁用存储桶版本控制。

与以下任一标志互斥：

• --versions

• --rewind

• --recursive

全局标志

此命令支持 全局标志 中的任意选项。

删除单个对象

mc rm ALIAS/PATH

• 将 ALIAS 替换为已配置的 S3 兼容服务的 alias。

• 将 PATH 替换为对象路径。

递归删除存储桶内容

将 mc rm 与 --recursive 和 --force 选项结合使用， 可递归删除存储桶内容。

mc rm --recursive --force ALIAS/PATH

• 将 ALIAS 替换为已配置的 S3 兼容服务的 alias。

• 将 PATH 替换为存储桶路径。

此操作 不会 删除存储桶本身。请使用 mc rb 删除存储桶 及其全部内容和关联配置。

删除对象的所有不完整上传文件

将 mc rm 与 --incomplete 选项结合使用， 可删除某个对象的不完整上传文件。

mc rm --incomplete --recursive --force ALIAS/PATH

• 将 ALIAS 替换为已配置的 S3 兼容服务的 alias。

• 将 PATH 替换为对象路径。

将对象回滚到先前版本

将 mc rm 与 --versions 和 --newer-than 结合使用，可删除新于指定时长的 所有对象版本。这会有效地将对象“回滚”到该时间点的状态。

mc rm ALIAS/PATH --versions --newer-than DURATION

• 将 ALIAS 替换为已配置的 S3 兼容服务的 alias。

• 将 PATH 替换为对象路径。 例如：/mybucket/myobject。

• 将 DURATION 替换为相对于当前主机时间的过去时长， 操作将从该时间点开始删除对象版本。例如，要删除过去 30 天内 创建的所有对象版本，请指定 "30d"。

删除存储桶内容

使用 mc rm 删除存储桶中的全部内容时，不会删除存储桶本身。 与该存储桶关联的配置会保留，例如 default object lock settings。

如需彻底删除存储桶，请使用 mc rb，而不是 mc rm。

MinIO 在删除对象时会清理空前缀

mc rm 依赖 mc 的删除 API 来移除对象。在删除存储桶前缀中的最后一个对象时， mc 还会递归删除直到存储桶根为止的每一个空前缀。mc 只会对在对象写入 操作过程中 隐式 创建的前缀执行这种递归删除，也就是说，该前缀不是通过 mc mb 这类显式目录创建命令创建的。

例如，假设存储桶 photos 中有以下对象前缀：

• photos/2021/january/myphoto.jpg

• photos/2021/february/myotherphoto.jpg

• photos/NYE21/NewYears.jpg

photos/NYE21 是 唯一 通过 mc mb 显式创建的前缀。其余所有前缀 都是在向该前缀写入对象时 隐式 创建的。

如果某个 mc 命令删除了 myphoto.jpg，删除 API 会自动裁剪空的 /january 前缀。如果后续某个 mc 命令又删除了 myotherphoto.jpg， 删除 API 会自动裁剪 /february 前缀，以及此时已经为空的 /2021 前缀。 如果某个 mc 命令删除了 NewYears.jpg，由于 /NYE21 是 显式 创建的，因此该前缀会保留不变。

如果将 mc rm 用于文件系统操作，mc 也会采用相同行为，递归裁剪直到 根目录的所有空目录。不过，mc 的删除 API 无法区分某个目录路径是显式 创建的，还是隐式创建的。如果 mc rm 删除了某个文件系统路径上的最后一个对象， mc 会在删除过程中递归删除从该路径向上直到根目录的所有空目录。

版本化存储桶中的删除操作

MinIO 支持在单个存储桶中保留对象的多个 版本。 在版本化存储桶中 删除 对象时， 会生成一种特殊的 DeleteMarker 墓碑记录，将对象标记为已删除， 同时保留该对象的所有先前版本。

• 要从存储桶中删除对象的特定版本，请使用 mc rm --version-id

• 要从存储桶中删除对象的所有版本，请使用 mc rm --versions

• 要从存储桶中删除对象的所有非当前版本，请使用 mc rm --non-current

S3 兼容性

mc 命令行工具以兼容 AWS S3 API 为目标构建，并针对 MinIO 和 AWS S3 进行了测试，以验证预期的功能与行为。

对于其他 S3 兼容服务，MinIO 不提供任何保证，因为这些服务的 S3 API 实现未知， 因此不在支持范围内。虽然 mc 命令 可能 仍能按文档说明工作，但此类 用法需要你自行承担风险。