`mc retention clear`

语法

Themc retention clear命令移除Write-Once Read-Many (WORM) 锁定存储桶中对象或对象的设置。您也可以移除存储桶的默认对象锁定设置。

要更改对象在法律保留, 使用mc legalhold clear.

EXAMPLE

以下命令移除默认的对象锁定配置mydata桶上的myminioMinIO 部署：

mc retention clear --default myminio/mydata

SYNTAX

该命令具有以下语法：

mc [GLOBALFLAGS] retention clear           \
                 [--default]               \
                 [--recursive]             \
                 [--rewind "string"]       \
                 [--version-id "string"]*  \
                 [--versions]              \
                 ALIAS

Brackets[]表示可选参数。
共享同一行的参数是相互依赖的。
使用竖线分隔的参数|操作符是互斥的。

将示例复制到文本编辑器中，根据需要修改，然后在终端/Shell中运行命令。

mc retention clear --version-id与多个其他参数互斥。有关更多信息，请参阅参考文档。

参数

ALIAS

必需

要清除对象锁定配置的对象或对象的完整路径。指定alias配置的 S3 兼容服务的前缀作为ALIASbucket 路径。例如：

mc retention clear play/mybucket/object.txt

如果ALIAS指定一个存储桶或存储桶前缀，包含
--recursive清除对象锁定设置到存储桶内容。
如果ALIAS存储桶已启用版本控制功能，
mc retention clear默认情况下仅适用于最新的对象版本。使用--version-id or --versions清除对象的特定版本或所有版本的对象锁定设置。

--default

可选

清除指定存储桶的默认对象锁定设置ALIAS.

如果指定--default, mc retention clear忽略所有其他标志。

--recursive, r

可选

递归清除指定对象中所有对象的对象锁定设置ALIASpath.

与以下内容互斥--version-id.

--rewind

可选

Directsmc retention clear仅对指定时间点存在的对象版本进行操作。

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

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

--version-id, vid

可选

Directsmc retention clear仅对指定的对象版本进行操作。

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

与以下任何标志互斥：

--versions
--rewind
--recursive

--versions

可选

Directsmc retention clear对存储桶中存在的所有对象版本执行操作。

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

使用--versions和--rewind共同移除在特定时间点存在的所有对象版本的保留设置。

全局标志

此命令支持任何全局标志.

示例

清除对象或对象的对象锁定设置

特定对象

mc retention clear ALIAS/PATH

替换ALIAS随着alias已配置的 S3 兼容主机。
替换PATH指向该对象的路径。

多个对象

使用mc retention clearwith--recursive要清除存储桶中所有对象的保留设置：

mc retention clear --recursive ALIAS/PATH

替换ALIAS随着alias已配置的 S3 兼容主机。
替换PATH使用存储桶的路径。

这个存储桶必须要使用此命令，需要启用对象锁定功能。您只能在创建存储桶时启用对象锁定功能。请参阅mc mb --with-lock有关启用对象锁定功能创建存储桶的更多信息。

S3 Compatibility

Themc命令行工具专为兼容 AWS S3 API 而构建，并已通过 MinIO 和 AWS S3 测试，确保功能与行为符合预期。

MinIO 不提供对其他 S3 兼容服务的保证，因为它们的 S3 API 实现方式未知，因此不受支持。尽管mc命令可能按文档所述工作，任何此类使用风险自负。