Bucket Versioning

版本化对象的读取操作

请查看本系列中的四张图片，了解 MinIO 如何在版本化存储桶中检索对象。 使用图片两侧的箭头在不同图片间切换浏览。

具有单一版本的对象

MinIO 为每个对象添加唯一的版本 ID 作为写入操作的一部分。

具有多个版本的对象

MinIO 保留对象的所有版本，并将最新版本标记为“latest”。

检索最新对象版本

不带版本ID的读取操作请求将返回对象的最新版本。

检索特定对象版本

包含版本ID以在读取操作期间检索对象的特定版本。

MinIO 隐式地从对象路径中确定前缀。 显式前缀创建通常仅发生在 Spark 和类似工作负载中，这些工作负载在 S3 上下文中应用传统的 POSIX/HDFS 目录创建行为。

版本控制是按命名空间进行的

MinIO 使用每个对象的完整命名空间（存储桶和对象路径） 作为确定对象唯一性的一部分。例如，以下所有 命名空间都是"唯一"对象，其中每个对象的修改都会 导致创建新的对象版本在该命名空间:

databucket/object.blob
databucket/blobs/object.blob
blobbucket/object.blob
blobbucket/blobs/object.blob

而object.blob可能在不同命名空间中使用相同的二进制文件， MinIO 仅对特定命名空间强制执行版本控制，因此 将每个object.blob以上内容作为独立且独特的。

版本控制与存储容量

MinIO 不执行增量或差异类型的版本控制。对于变更频繁的工作负载，这可能导致较旧或老化的对象版本占用大量存储空间。

例如，考虑一个包含日志数据的1GB对象。应用程序向日志追加100MB数据并上传到MinIO。此时MinIO将同时包含该对象的1GB和1.1GB版本。如果应用程序连续10天每天重复此过程，最终存储桶中将包含超过14GB与单个对象关联的数据。

MinIO 支持配置对象生命周期管理规则自动过期或转换旧的对象版本并释放存储容量。例如，您可以配置规则，在对象版本变为非当前版本（即不再是该对象的"最新"版本）90天后自动将其过期。参见MinIO Object Expiration如需 更多信息。

您也可以使用以下命令手动删除对象版本：

• mc rm --versions- 删除对象的所有版本。

• mc rm --versions --older-than -

  删除指定日历日期之前的所有对象版本。

版本ID生成

MinIO 为每个版本化对象生成一个唯一且不可变的标识符作为写入操作的一部分。每个对象版本 ID 由 128 位固定大小组成UUIDv4UUID生成具有足够的随机性，能确保在任何环境下都具有很高的唯一性概率，在计算上难以被猜测，且无需通过集中式注册流程和权威机构来保证唯一性。

MinIO 不支持客户端管理的版本 ID 分配。所有版本 ID 生成均由 MinIO 服务器进程处理。

对于在版本控制被禁用或暂停期间创建的对象，MinIO 使用一个null版本ID。您可以通过指定这些版本来访问或删除这些对象。null作为 S3 操作中的版本 ID。

版本化删除操作

执行一个DELETE对版本化对象的操作会创建一个0字节的DeleteMarker作为该对象的最新版本。 对于最新版本为DeleteMarker客户端必须指定版本控制标志或标识符才能执行GET/HEAD/LIST/DELETE对该对象的先前版本的操作。 默认服务器行为会省略DeleteMarker在无版本操作中排除对象考虑。

MinIO 可以充分利用生命周期管理过期规则自动永久移除版本化对象。 否则，请使用手动方式DELETE永久删除非当前版本对象的操作或DeleteMarkerobjects.

要永久删除对象版本，请执行DELETE操作并 指定要删除的对象的版本ID。版本化删除操作不可逆的.

删除对象

执行一个DELETE对版本化对象的操作会产生DeleteMarker对于该对象。

读取已删除的对象

默认情况下，客户端检索"最新"的对象版本。MinIO返回一个404如果最新版本是a，则返回类似响应DeleteMarker.

检索已删除对象的先前版本

客户端可以通过指定版本ID检索对象的任何先前版本，即使"最新"版本是DeleteMarker.

删除特定对象版本

客户端可以通过指定版本ID作为请求的一部分来删除特定对象版本DELETE操作。删除特定版本是永久的并且不会导致创建DeleteMarker.

以下内容mc命令操作于DeleteMarkers或版本化对象：

• 使用mc ls --versions要查看对象的所有版本， 包括删除标记。

• 使用mc cp --version-id=UUID ...要 检索具有匹配版本的“已删除”对象UUID.

• 使用mc rm --version-id=UUID ...删除 具有匹配版本的对象UUID.

• 使用mc rm --versions删除全部对象的版本。

启用存储桶版本控制

您可以使用 MinIO 控制台启用版本控制，MinIOmcCLI，或 使用兼容 S3 的 SDK。

使用mc version enable在现有存储桶上启用版本控制的命令：

mc version enable ALIAS/BUCKET

• 替换ALIAS随着alias已配置的 MinIO 部署。

• 替换BUCKET随着target bucket要启用版本控制的

在启用版本控制之前创建的对象具有null 版本 ID.

从版本控制中排除前缀

您可以排除某些前缀从使用版本控制开始MinIO 客户端这对于 Spark/Hadoop 工作负载或其他最初使用临时前缀创建对象的场景非常有用。

• 使用mc version enable随着--excluded-prefixes选项：

  mc version enable --excluded-prefixes "prefix1, prefix2" ALIAS/BUCKET
  

  • 替换ALIAS随着alias已配置的 MinIO 部署。

  • 替换BUCKET名为桶你想排除前缀for.

列表--excluded-prefixes前缀匹配所有在其前缀或名称中包含指定字符串的对象，类似于形式为的正则表达式prefix*要仅通过前缀匹配对象，请使用prefix/*.

例如，以下命令会排除包含_test or _temp在其前缀或名称中不进行版本控制：

mc version enable --excluded-prefixes "_test, _temp" local/my-bucket

您可以为每个存储桶排除最多10个前缀。 要添加或删除前缀，请重复mc version enable使用更新后的前缀列表执行命令。 新的前缀列表将替换之前的列表。

要查看当前排除的前缀，请使用mc version info随着--json选项：

mc version info ALIAS/BUCKET --json

命令输出类似于以下内容，其中包含排除前缀列表：ExcludedPrefixes属性：

$ mc version info local/my-bucket --json
{
 "Op": "info",
 "status": "success",
 "url": "local/my-bucket",
 "versioning": {
  "status": "Enabled",
  "MFADelete": "",
  "ExcludedPrefixes": [
   "prefix1, prefix2"
  ]
 }
}

要禁用前缀排除并恢复对所有前缀的版本控制，请重复mc version enable命令不带参数--excluded-prefixes:

mc version enable ALIAS/BUCKET

从版本控制中排除文件夹

您可以使用以下方法将文件夹排除出版本控制：MinIO 客户端.

• 使用mc version enable随着--exclude-folders排除名称以指定后缀结尾的对象的选项/from versioning:

  mc version enable --exclude-folders ALIAS/BUCKET
  

  • 替换ALIAS随着alias已配置的 MinIO 部署。

  • 替换BUCKET随着桶你想排除文件夹for.

要检查存储桶中的文件夹是否已启用版本控制，请使用mc version enable带有命令的--json选项。 如果ExcludeFolders属性是true该存储桶中的文件夹未启用版本控制。

mc version enable --excluded-prefixes ALIAS/BUCKET --json

命令输出类似于以下内容：

$ mc version info local/my-bucket --json
{
 "Op": "info",
 "status": "success",
 "url": "local/my-bucket",
 "versioning": {
  "status": "Enabled",
  "MFADelete": "",
  "ExcludeFolders": true
 }
}

要禁用文件夹排除并恢复对所有文件夹的版本控制，请重复执行mc version enable命令不带参数--exclude-folders:

mc version enable ALIAS/BUCKET

暂停存储桶版本控制

您可以使用 MinIO 随时暂停存储桶版本控制。mcCLI 或使用 S3 兼容的 SDK。

使用mc version suspend在现有存储桶上启用版本控制的命令：

mc version suspend ALIAS/BUCKET

• 替换ALIAS随着alias已配置的 MinIO 部署。

• 替换BUCKET随着target bucket要禁用版本控制的

版本控制暂停期间创建的对象被分配一个null 版本 ID在版本控制暂停期间对对象进行的任何修改都会导致该对象被覆盖null版本化对象。 MinIO 在暂停版本控制时不会删除或以其他方式更改现有的版本化对象。 客户端可以继续与存储桶中的任何现有对象版本进行交互。