`mc legalhold set`

语法

The mc legalhold set 命令为对象或对象启用法律保留一次写入多次读取 (WORM) 对象锁定。

mc legalhold 需要指定的存储桶已启用对象锁定。您只能在创建存储桶时启用对象锁定。有关使用启用对象锁定的创建存储桶的文档，请参阅 mc mb --with-lock。

示例

以下命令将对 myminio MinIO 部署上的 mydata 存储桶中的所有现有对象启用 legalhold WORM 锁定。

mc legalhold set --recursive myminio/mydata

语法

该命令具有以下语法。

mc [GLOBALFLAGS] legalhold set  \
                 [--recursive]  \
                 [--rewind]     \
                 [--version-id] \
                 ALIAS

方括号 [] 表示可选参数。
共享一行的参数是相互依赖的。
使用管道 | 运算符分隔的参数是互斥的。

将示例复制到文本编辑器中，并在终端/shell 中运行命令之前根据需要进行修改。

参数

ALIAS

必需

MinIO 别名以及要对其启用法律保留的对象或对象的路径。例如

mc legalhold set play/mybucket/myobjects/objects.txt

--recursive, r: 可选
将法律保留应用于 ALIAS 存储桶或存储桶前缀中的所有现有对象。

--recursive 仅适用于现有对象。

要为将来的对象启用法律保留，请在创建新对象时定期重复 mc legalhold 命令。

--rewind

可选

指示 mc legalhold set 仅对指定时间点存在的对象版本进行操作。

要回溯到过去的特定日期，请将日期指定为 ISO8601 格式的时间戳。例如：--rewind "2020.03.24T10:00"。
要回溯一段时间，请将时间段指定为 #d#hh#mm#ss 格式的字符串。例如：--rewind "1d2hh3mm4ss"。

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

--version-id, vid

可选

指示 mc legalhold set 仅对指定的对象版本进行操作。

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

全局标志

该命令支持任何全局标志。

示例

使用 mc legalhold set 在对象上启用法律保留。

mc legalhold set [--recursive] ALIAS/PATH

用 ALIAS 替换 S3 兼容主机的别名。
用 PATH 替换 S3 兼容主机上存储桶或对象的路径。如果指定存储桶或存储桶前缀的路径，请包括 --recursive 选项。

行为

法律保留需要显式删除

法律保留是无限期的，并强制对锁定对象进行完全不可变性。只有拥有 s3:PutObjectLegalHold 权限的特权用户才能设置或取消法律保留。

法律保留补充其他保留模式

法律保留补充治理模式和合规模式保留设置。法律保留和 GOVERNANCE/COMPLIANCE 保留规则共同保留的对象将一直处于 WORM 锁定状态，直到法律保留被取消并且规则过期。

对于 GOVERNANCE 锁定的对象，法律保留会阻止修改对象，即使用户具有绕过保留的必要权限。

S3 兼容性

mc 命令行工具是为与 AWS S3 API 兼容而构建的，并使用 MinIO 和 AWS S3 进行了测试，以确保预期功能和行为。

MinIO 不对其他 S3 兼容服务提供任何保证，因为它们的 S3 API 实现是未知的，因此不受支持。虽然 mc 命令可能按文档记录的方式工作，但任何此类使用都是您自己的风险。