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

`mc legalhold`

Table of Contents

描述
例子
语法

描述

mc legalhold 命令启用或禁用对象合法保留。对对象启用合法保留可防止对对象进行任何修改或删除，相当于在对象上设置一次写入只读 (WORM) 模式。

Important

mc legalhold requires 指定的存储桶启用了对象锁定。您可以 only 在创建存储桶时启用对象锁定。

有关创建启用了对象锁定的存储桶的文档，请参阅 mc mb --with-lock。

例子

启用合法保留对象

使用 :mc-command:`mc legal hold set` 启用对对象的合法保留:

mc legalhold set [--recursive] ALIAS/PATH

将 :mc-command:`ALIAS <mc legal hold set TARGET>` 替换为 S3 兼容主机的 alias。
将 PATH 替换为 S3 兼容主机上的存储桶或对象的路径。

如果指定存储桶的路径，请包含 --recursive 选项。

从存储桶中删除合法保留

使用 :mc-command:`mc legal hold clear` 删除对对象的合法保留:

mc legalhold clear [--recursive] ALIAS/PATH

将 :mc-command:`ALIAS <mc legal hold clear TARGET>` 替换为 S3 兼容主机的 alias。
将 PATH 替换为 S3 兼容主机上的存储桶或对象的路径。如果指定存储桶的路径，请包括 --recursive 选项。

检索合法保留状态对象

使用:mc-command:mc legal hold info 来检索一个对象的合法保留状态。包括:mc-cmd-option:~mc legal hold info recursive 返回一个bucket 内容的合法保留状态:

mc legalhold clear [--recursive] ALIAS/PATH

将 :mc-command:`ALIAS <mc legal hold clear TARGET>` 替换为 S3 兼容主机的 alias。
将 PATH 替换为对象的路径或 S3 兼容主机上的存储桶。如果指定存储桶的路径，包括 --recursive 选项。

语法

mc legalhold set

启用对一个或多个对象的合法保留。

该命令具有以下语法:

mc legalhold set [FLAGS] TARGET

该命令接受以下参数:

TARGET

Required

启用合法保留的对象或存储桶的完整路径。指定配置的 S3 兼容服务的 alias 作为 TARGET 路径的前缀。例如:

mc legalhold set play/mybucket/myobject.txt

如果您指定存储桶或存储桶前缀的路径，则还必须指定 mc legalhold set --recursive。

--recursive, --r: 将合法保留应用于 :mc-command:`~mc 合法保留集 TARGET` 桶或桶前缀中的所有对象。

--rewind

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

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

--rewind 要求指定的 --TARGET 成为 S3 兼容的服务支持 Bucket Versioning. 对于 MinIO 部署，请使用 mc version 启用或禁用存储版本控制。

--version-id, --vid

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

--version-id 要求指定的 --TARGET 成为 S3 兼容的服务支持 Bucket Versioning. 对于 MinIO 部署，请使用 mc version 启用或禁用存储版本控制。

clear

删除对一个或多个对象的合法保留。

该命令具有以下语法:

mc legalhold clear [FLAGS] TARGET

该命令接受以下参数:

TARGET

Required 要删除合法保留的对象或存储桶的完整路径。指定配置的 S3 兼容服务的 alias 作为 TARGET 路径的前缀。例如:

mc legalhold set play/mybucket/myobject.txt

如果您指定存储桶或存储桶前缀的路径，则还必须指定 mc legalhold set --recursive。

--recursive, --r: 从 :mc-command:`~mc legal hold set TARGET` 存储桶或存储桶前缀中的所有对象中删除合法保留。

--rewind

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

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

--rewind 要求指定的 --TARGET 成为 S3 兼容的服务支持 Bucket Versioning. 对于 MinIO 部署，请使用 mc version 启用或禁用存储版本控制。

--version-id, --vid

指导 mc legalhold clear 仅对指定的对象版本进行操作。

--version-id 要求指定的 --TARGET 成为 S3 兼容的服务支持 Bucket Versioning. 对于 MinIO 部署，请使用 mc version 启用或禁用存储版本控制。

info

检索一个或多个对象的合法保留状态。

该命令具有以下语法:

mc legalhold info [FLAGS] TARGET

该命令接受以下参数:

TARGET

Required 要检索其合法保留状态的对象或存储桶的完整路径。指定配置的 S3 兼容服务的 alias 作为 TARGET 路径的前缀。例如:

mc legalhold set play/mybucket/myobject.txt

如果您指定存储桶或存储桶前缀的路径，则还必须指定 mc legalhold set --recursive。

--recursive, --r: 从 :mc-command:`~mc legal hold set TARGET` 桶或桶前缀中的所有对象中检索合法保留。

--rewind

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

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

--rewind 要求指定的 --TARGET 成为 S3 兼容的服务支持 Bucket Versioning. 对于 MinIO 部署，请使用 mc version 启用或禁用存储版本控制。

--version-id, --vid

指导 mc legalhold info 仅对指定的对象版本进行操作。

--version-id 要求指定的 --TARGET 成为 S3 兼容的服务支持 Bucket Versioning. 对于 MinIO 部署，请使用 mc version 启用或禁用存储版本控制。