`mc undo`

语法

mc undo 命令用于撤销指定路径上由 PUT 或 DELETE 操作引起的更改。

示例

以下命令会回滚 myminio 部署中 data 存储桶内 file.zip 对象最近三次上传和/或删除操作：

mc undo myminio/data/file.zip --last 3

语法

命令语法如下：

mc [GLOBALFLAGS] undo                \
                 TARGET              \
                 [--action "type"]   \
                 [--force]           \
                 [--last "integer"]  \
                 [--recursive, r]    \
                 [--dry-run]

方括号 [] 表示可选参数。
同一行中的参数彼此相互依赖。
使用管道符 | 分隔的参数彼此互斥。

请先将示例复制到文本编辑器中并按需修改，再在终端 / shell 中运行命令。

参数

TARGET: Required
命令应执行的对象或前缀的完整路径。路径必须包含 ALIAS、存储桶以及前缀或对象名称。

--action

Optional

撤销指定类型的最近一次更改。可接受的值为 DELETE 或 PUT。

默认情况下，mc undo 会同时回滚 DELETE 和 PUT 操作。使用 --action 可在两者中选择其一，但仅针对该类型最近的一次操作。

以下命令会回滚 data 存储桶中对象 today.zip 最近一次 PUT，恢复到该对象的上一版本：

mc undo myminio/data/today.zip --action "PUT"

以下示例会回滚前缀 archive 最近一次 DELETE，并递归恢复该前缀及其所有子对象：

mc undo myminio/data/archive --recursive --action "DELETE"

与 --last 互斥。

--dry-run: Optional
输出命令结果，但不实际执行操作。使用此标志可测试按特定方式运行命令时的结果。

--force: Optional
强制执行递归操作。

--last

Optional

接受一个整数值，用于指定要撤销的 PUT 和/或 DELETE 更改次数。

若未指定，命令默认回滚一次（1）操作。与 --action 互斥。

--recursive, r: Optional
以递归方式执行命令。例如，可使用此标志撤销某个前缀上的更改。

全局标志

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

示例

撤销对象最近三次上传或删除

以下命令会回滚 myminio 部署中 data 存储桶内 file.zip 对象最近三次上传和/或删除操作：

mc undo myminio/data/file.zip --last 3

撤销某个前缀下任意对象最近一次上传或删除

使用 mc undo 回滚在 myminio 别名下、data 存储桶中 presentations/recordings/ prefix 内最近一次 PUT 或 DELETE 操作：

mc undo myminio/data/presentations/recordings/ --recursive --force

行为

S3 兼容性

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

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