`mc retention info`

语法

Themc retention info命令配置Write-Once Read-Many (WORM) 锁定设置存储桶中一个或多个对象的锁定设置。您还可以设置存储桶的默认对象锁定设置，这样所有未设置显式对象锁定设置的对象都将继承存储桶的默认设置。

锁定对象于法律保留使用,mc legalhold set.

mc retention info 需要指定的存储桶已启用对象锁定功能。您可以仅在存储桶创建时启用对象锁定。请参阅mc mb --with-lock有关创建启用了对象锁定的存储桶的文档。

EXAMPLE

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

mc retention info --default myminio/mydata

SYNTAX

该命令具有以下语法：

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

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

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

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

参数

ALIAS

必需

要检索对象锁定配置的对象的完整路径。指定别名配置的 S3 兼容服务的前缀作为ALIASbucket 路径。例如：

mc retention info play/mybucket/object.txt

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

--default

可选

返回指定存储桶的默认对象锁定设置ALIAS.

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

--recursive, r

可选

递归返回指定存储桶中所有对象的对象锁定设置ALIASpath.

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

--rewind

可选

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

要回滚到过去的特定日期，请将日期指定为 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 info仅对指定的对象版本进行操作。

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

与以下任何标志互斥：

--versions
--rewind
--recursive

--versions

可选

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

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

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

全局标志

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

示例

检索对象或对象的对象锁定设置

特定对象

mc retention info ALIAS/PATH

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

多个对象

使用mc retention infowith--recursive要检索存储桶中所有对象的保留设置：

mc retention info --recursive ALIAS/PATH

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

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

检索存储桶的默认对象锁定设置

使用mc retention infowith--default要检索存储桶的默认对象锁定设置：

mc retention info --default ALIAS/PATH

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

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

S3 Compatibility

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

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