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

mc retention

描述

:mc:`mc retention`命令配置一次写入多次读取(WORM)对象 存储桶中一个或多个对象的锁定设置。 您还可以为存储桶设置默认对象锁定设置, 其中没有明确对象锁定设置的所有对象都继承存储桶默认值。

Note

从版本 RELEASE.2020-09-18T00-13-21Z 开始, mc  retention 完全取代了 mc lock 用于设置存储桶的默认对象锁定设置。

使用 mc retention set 与 :mc-cmd-option:`~mc retention set default`选项设置默认 存储桶的对象锁定设置。

存储桶必须启用对象锁定

mc retention requires 指定的存储桶启用了对象锁定。 您可以 only 在创建存储桶时启用对象锁定。 看 mc mb --with-lock 有关创建启用对象锁定的存储桶的文档。

对象版本的保留

对于带有 versioning enabled, mc retention 默认情况下,对目标对象的 latest 版本进行操作。 mc retention 包括特定选项,当 explicitly 指定时, 会指示命令对特定对象版本 or 对象的所有版本进行操作:

要指示 mc retention 对对象的特定版本进行操作,请包含 --version-id 参数:

要指示 mc retention 对对象的 all 版本进行操作,请包含 --versions 参数:

与合法保留的交互

锁定对象可防止对其进行任何修改或删除 对象,类似于 COMPLIANCE 对象锁定模式。 对象可以同时拥有基于保留的锁 and 合法的保持锁。

合法保留锁定 overrides 任何保留锁定,因此合法保留下的对象保持锁定 even if 保留期到期。 在合法保留到期或被明确禁用之前,为处于合法保留状态的对象设置、修改或清除保留设置无效。

有关对象合法保留的更多信息,请参阅 mc legalhold.

例子

设置默认存储桶保留设置

使用 mc retention set--recursive--default 设置默认存储桶保留设置。

mc retention set  --recursive --default MODE DURATION ALIAS/PATH
  • MODE 替换为要启用的保留模式。 MinIO 支持 AWS S3 保留模式``governance``和 compliance

  • 用对象锁应该保持有效的持续时间替换 DURATION。 例如,要将保留期设置为 30 天,请指定“30d”。

  • ALIAS 替换为 alias 配置的 S3 兼容主机。

  • PATH 替换为存储桶的路径。

The bucket must have object locking enabled to use this command. You can only enable object locking when creating a bucket. See mc mb --with-lock for more information on creating buckets with object locking enabled.

为受版本控制的对象设置对象锁定配置

使用 mc retention set--version-id 将保留设置应用于特定对象版本:

mc retention set --version-id VERSION MODE DURATION ALIAS/PATH
  • VERSION 替换为对象的版本。

  • MODE 替换为要启用的保留模式。 MinIO 支持 AWS S3 保留模式 governancecompliance

  • 用对象锁应该保持有效的持续时间替换 DURATION。 例如,要将保留期设置为 30 天,请指定 “30d”。

  • ALIAS 替换为 alias 配置的 S3 兼容主机。

  • PATH 替换为对象的路径。

使用 mc retention set--versions 将保留设置应用于特定对象版本:

mc retention set --versions  MODE DURATION ALIAS/PATH
  • MODE 替换为要启用的保留模式。 MinIO 支持 AWS S3 保留模式 governancecompliance

  • 用对象锁应该保持有效的持续时间替换 DURATION。 例如,要将保留期设置为 30 天,请指定 “30d”。

  • ALIAS 替换为 alias 配置的 S3 兼容主机。

  • 用对象的路径替换 PATH

The bucket must have object locking enabled to use this command. You can only enable object locking when creating a bucket. See mc mb --with-lock for more information on creating buckets with object locking enabled.

检索一个或多个对象的对象锁定设置

mc retention info ALIAS/PATH
  • ALIAS 替换为 alias 配置的 S3 兼容主机。

  • PATH 替换为对象的路径。

mc retention info--recursive 检索存储桶中所有对象的保留设置:

mc retention info --recursive ALIAS/PATH
  • ALIAS 替换为 alias 配置的 S3 兼容主机。

  • PATH 替换为存储桶的路径。

The bucket must have object locking enabled to use this command. You can only enable object locking when creating a bucket. See mc mb --with-lock for more information on creating buckets with object locking enabled.

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

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

mc retention info --default ALIAS/PATH
  • ALIAS 替换为 alias 配置的 S3 兼容主机。

  • PATH 替换为存储桶的路径。

The bucket must have object locking enabled to use this command. You can only enable object locking when creating a bucket. See mc mb --with-lock for more information on creating buckets with object locking enabled.

清除一个或多个对象的对象锁定设置

mc retention clear ALIAS/PATH
  • ALIAS 替换为 alias 配置的 S3 兼容主机。

  • PATH 替换为对象的路径。

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

mc retention clear --recursive ALIAS/PATH
  • ALIAS 替换为 alias 配置的 S3 兼容主机。

  • PATH 替换为存储桶的路径。

The bucket must have object locking enabled to use this command. You can only enable object locking when creating a bucket. See mc mb --with-lock for more information on creating buckets with object locking enabled.

语法

mc retention set

为指定的对象设置对象锁定设置 TARGET 对象。

mc retention set 具有以下语法:

mc retention set [FLAGS] MODE VALIDITY TARGET

mc retention set 支持以下论点:

MODE

设置 TARGET 的锁定模式。 指定以下支持的值之一:

  • governance

  • compliance

请参阅 AWS S3 文档 Object Lock Overview 有关支持的模式的更多信息。

需要指定 VALIDITY.

VALIDITY

对象保留在指定范围内的持续时间 MODE 后创建。

  • 对于几天,指定一个格式为 “Nd” 的字符串。 例如, 30d 对象创建后 30 天。

  • 多年来,指定一个格式为 “Ny” 的字符串。 例如, 1y 对象创建后 1 年。

TARGET

Required

要为其设置对象锁定配置的一个或多个对象的完整路径。 将配置的 S3 兼容服务的 alias 指定为 TARGET 存储桶路径的前缀。 例如:

mc retention play/mybucket/object.txt MODE VALIDITY
  • 如果 TARGET 指定了存储桶或存储桶前缀,则包括 --recursive 将对象锁定设置应用于存储桶内容。

  • 如果 TARGET 存储桶启用了版本控制, mc retention set 默认情况下,仅适用于最新的对象版本。 用 --version-id--versions 将对象锁定设置应用于特定版本或对象的所有版本。

--bypass

允许具有 s3:BypassGovernanceRetention 权限的用户修改对象。 需要 governance 保留 MODE

--recursive, --r

将对象锁定设置递归应用于指定 TARGET 路径中的所有对象。

--version-id 互斥.

--default

将指定的存储桶的默认对象锁定设置设置为 TARGET 使用 MODEVALIDITY. 除非使用显式覆盖,否则存储桶中创建的任何对象都会继承默认对象锁定设置 mc retention set.

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

RELEASE.2020-09-18T00-13-21Z 开始, mc retention set --default 替换了已弃用的 mc lock 命令的功能。

--rewind

指导 mc retention 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 retention set 仅对指定的对象版本进行操作。

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

与以下任何标志互斥:

--versions

指导 mc retention set 对存储中存在的所有对象版本进行操作。

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

使用 --versions--rewind 以将保留设置应用于特定时间点存在的所有对象版本。

mc retention info

返回指定对象的当前对象锁定设置 TARGET.

mc retention info 具有以下语法:

mc retention info [ARGUMENTS] TARGET

mc retention info 支持以下论点:

TARGET

Required

要检索其对象锁定配置的对象的完整路径。 将配置的 S3 兼容服务的 alias 指定为 TARGET 存储桶路径的前缀。 例如:

mc retention info play/mybucket/object.txt
  • 如果 TARGET 指定了存储桶或存储桶前缀,则包括 --recursive 返回存储桶或存储桶前缀中所有对象的对象锁定设置。

  • 如果 TARGET 存储桶启用了版本控制, mc retention info 默认情况下,仅适用于最新的对象版本。 用 --version-id--versions 返回特定版本或对象所有版本的对象锁定设置。

--recursive, --r

递归返回指定 TARGET 路径中所有对象的对象锁定设置。

--version-id 互斥.

--default

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

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

RELEASE.2020-09-18T00-13-21Z 开始, mc reserved info --default 替换了已弃用的 mc lock 命令的功能。

--rewind

指导 mc retention 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 retention info 仅对指定的对象版本进行操作。

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

与以下任何标志互斥:

--versions

指导 mc retention info 对存储中存在的所有对象版本进行操作。

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

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

mc retention clear

清除指定 TARGET 的对象锁定设置。

mc retention clear 具有以下语法:

mc retention clear [ARGUMENTS] TARGET

mc retention clear 支持以下论点:

TARGET

Required 要清除其对象锁定配置的一个或多个对象的完整路径。 将配置的 S3 兼容服务的 alias 指定为 TARGET 存储桶路径的前缀。 例如:

mc retention clear play/mybucket/object.txt
  • 如果 TARGET 指定了存储桶或存储桶前缀,则包括 --recursive 清除存储桶内容的对象锁定设置。

  • 如果 TARGET 存储桶启用了版本控制, mc retention clear 默认情况下,仅适用于最新的对象版本。 用 --version-id--versions 清除特定版本或对象所有版本的对象锁定设置。

--recursive, --r

递归清除指定 TARGET 路径中所有对象的对象锁定设置。

--version-id 互斥.

--default

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

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

RELEASE.2020-09-18T00-13-21Z 开始, mc reserved clear --default 替换了已弃用的 mc lock 命令的功能。

--rewind

指导 mc retention 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 retention clear 仅对指定的对象版本进行操作。

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

与以下任何标志互斥:

--versions

指导 mc retention clear 对存储中存在的所有对象版本进行操作。

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

使用 --versions--rewind 从特定时间点存在的所有对象版本中删除保留设置。