版本控制概述
版本控制是针对存储空间（Bucket）级别的数据保护功能。开启版本控制后，针对数据的覆盖和删除操作将会以历史版本的形式保存下来。您在错误覆盖或删除对象（Object）后，能够将存储在Bucket中的Object恢复至任意时刻的历史版本。
使用场景
建议您在以下场景中使用版本控制，为您的数据安全提供更好的保障。
- 数据误删除
- 您删除BOS数据后想要找回时，可使用版本控制功能，恢复已删除的数据。
- 文件被覆盖
- 对于网盘、在线协作类产品，文件会被频繁修改，针对文件的编辑会产生大量的临时版本。您可以使用版本控制功能找回某个时间点的版本。
注意事项
- 费用说明
版本控制功能本身不收取任何费用，但对当前版本和所有历史版本的文件都会收取存储费用。此外，若您对历史版本文件进行下载或恢复等操作，还会产生相应的请求费用、流量费用等。计费详情，请参见计量项与计费项。
- 权限说明
只有Bucket的拥有者及授予了PutBucketVersioning权限的RAM用户才能配置版本控制。
- 功能互斥
同一Bucket中，版本控制与合规保留策略无法同时配置。
如果Bucket已开启版本控制，上传文件时附加的覆盖同名文件请求头x-bce-forbid-overwrite将不生效。更多信息，请参见请求头。
同一Bucket中，版本控制和回收站无法同时配置。
在多版本初期阶段，存在多个功能互斥，多个az不支持多版本功能，具体详情可以询问相关技术人员。gz集群允许开启多版本。
版本控制状态
Bucket包含三种版本控制状态，分别为未开启、开启或者暂停。
默认情况下，Bucket版本控制状态为“未开启”。如果Bucket处于“开启”版本状态，将无法返回至“未开启”状态。但是，您可以暂停Bucket的版本控制状态。
当Bucket版本控制处于“开启”状态时，BOS将为新上传的Object生成全局唯一的随机字符串版本ID。
当Bucket版本控制处于“暂停”状态时，BOS将为新上传的Object生成特殊字符串为“null”的版本ID。
管理启用版本控制状态下的对象
写入对象
在已开启版本控制的Bucket中上传Object时，会为这些上传的Object添加唯一的版本ID。
列举对象
对象存储在与存储桶关联的 versions 参数中存储对象版本信息。 按照存储时间的先后顺序返回对象版Object，同名Object按照最近写入时间顺序。
下载对象
通过GET请求下载Object时，如果未指定Object的版本ID，默认情况下返回Object的最新版本。
如果最新版本为delete marker, 那么返回404
如果指定了Object的版本Id，返回指定版本的内容。
删除文件
如果删除Object时未指定版本ID，则Bucket中将插入一个删除标记（Delete Marker）作为当前版本。
如果删除Object时指定版本Id，那么该object就会被彻底删除。
恢复文件
恢复文件有两种方法可执行：
- 使用Copy接口将对象的早期版本复制到同一存储桶中
- 指定当前版本Id进行永久删除对象，那么历史版本就会成为最新版本。
管理暂停版本控制状态下的对象
写入对象
在已暂停版本控制的Bucket中上传Object时，Object的版本Id为空。
列举对象
对象存储在与存储桶关联的 versions 参数中存储对象版本信息。 按照存储时间的先后顺序返回对象版Object，同名Object按照最近写入时间顺序。
下载对象
和开启态的表现相同
删除文件
如果删除Object时未指定版本ID，则Bucket中将插入一个删除标记（Delete Marker）作为当前版本。该删除标记的版本Id为"null"
如果删除Object时指定版本Id，那么该object就会被彻底删除。
恢复文件
恢复文件有两种方法可执行：
- 使用Copy接口将对象的早期版本复制到同一存储桶中
- 指定当前版本Id进行永久删除对象，那么历史版本就会成为最新版本。