# 开启、暂停、查看多版本控制 #### 使用场景 默认情况下，OBS中新创建的桶不会开启多版本功能，向同一个桶上传同名的对象时，新上传的对象将覆盖原有的对象。 利用多版本控制，您可以在一个桶中保留多个版本的对象，使您更方便地检索和还原各个版本，在意外操作或应用程序故障时快速恢复数据，支持全新开启多版本控制或重新开启已暂停的多版本控制。 多版本控制功能开启后不支持关闭，如果您不再使用该功能，可以暂停多版本控制。 开启多版本控制后，您还可以查看多版本对象，便于您找回指定版本的数据。 #### 约束与限制 - 多版本控制一旦启动，不可关闭，只能暂停使用。 - 开启了桶级[WORM](https://support.huaweicloud.com/usermanual-obs/obs_03_0718.html)开关，需要先开启多版本控制。使用控制台配置WORM时，控制台会自动开启多版本，并且不允许暂停多版本。使用API配置WORM时，需要您自行调用[设置桶的多版本状态](https://support.huaweicloud.com/api-obs/obs_04_0037.html)接口开启多版本。 - 不支持对历史版本对象配置ACL、服务端加密和标签。 #### 费用说明 多版本控制功能免费，但当前版本对象（删除标记除外）和历史版本对象均占用存储空间，因此会收取[数据存储费用](https://support.huaweicloud.com/price-obs/obs_42_0003.html)。为避免产生不必要的存储费用，建议您及时删除对象，可[手动删除对象](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829108.html#ZH-CN_TOPIC_0000001919908844)或[通过生命周期规则自动删除不需要的对象](https://support.huaweicloud.com/usermanual-obs/obs_41_0074.html#ZH-CN_TOPIC_0000001945139386)。 #### 设置多版本控制 OBS支持通过[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)、API、SDK、OBS Browser+方式设置多版本控制，不支持通过obsutil方式设置多版本控制。 #### 使用OBS控制台 1. 在OBS[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)左侧导航栏选择"桶列表"。 2. 在桶列表中，单击待操作的桶，进入"对象"页面。 3. 在左侧导航栏，单击"概览"，进入"概览"页面。 4. 在"基础配置"区域下，单击"多版本控制"卡片，系统弹出多版本控制对话框。 或直接在左侧导航栏单击"数据安全 \> 多版本控制"，进入"多版本控制"界面。 图1配置多版本控制入口 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000001889224945.png "点击放大") 5. 开启或暂停多版本控制。 - 在多版本控制页面，打开开关并单击"保存"，**开启多版本控制** 。 图2开启多版本控制 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002625206690.png "点击放大") - 在多版本控制页面，关闭开关并单击"保存"，**暂停多版本控制** 。 图3暂停多版本控制 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002625285840.png "点击放大") #### 使用API - 如果您要配置桶的多版本控制，请使用[设置桶的多版本状态](https://support.huaweicloud.com/api-obs/obs_04_0037.html)。 - 如果您要查看桶的多版本控制状态，请使用[获取桶的多版本状态](https://support.huaweicloud.com/api-obs/obs_04_0038.html)。 #### 使用SDK | 设置桶多版本控制 | [Java](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1002.html) | [Python](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0827.html) | [C](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0802.html) | [Go](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0429.html) | [BrowserJS](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0902.html) | [.NET](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0802.html) | [Android](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0802.html) | [iOS](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0802.html) | [PHP](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0802.html) | [Node.js](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0802.html) | |---|---|---|---|---|---|---|---|---|---|---| | **获取桶多版本状态** | [Java](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1003.html) | [Python](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0828.html) | [C](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0803.html) | [Go](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0430.html) | [BrowserJS](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0903.html) | [.NET](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0803.html) | [Android](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0803.html) | [iOS](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0803.html) | [PHP](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0803.html) | [Node.js](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0803.html) | #### 使用图形化工具OBS Browser+ 1. 登录OBS Browser+。 2. 单击右键目标桶名称进入桶管理界面。 3. 单击"多版本控制"，开启或暂停多版本控制。 - 开启多版本控制：在弹出框选择"启用"，如[图4]所示。 图4多版本控制 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002655565991.png "点击放大") - 暂停多版本控制：在弹出框选择"暂停"，如[图5]所示。 图5多版本控制 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002625366606.png "点击放大") 4. 单击消息提示框中的"确定"。 #### 查看多版本对象（开启或暂停多版本状态下） **查看多版本对象前，请确保您的桶已开启或暂停多版本控制。** OBS支持通过[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)、API、SDK、OBS Browser+、obsutil方式查看多版本对象。 #### 使用OBS控制台 1. 在OBS[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)左侧导航栏选择"桶列表"。 2. 打开对象列表上方的"历史版本"开关。 对象列表将展示当前版本对象和历史版本对象（包含带删除标记的已删除对象），可以看到每个版本对象均带有唯一的一个版本ID。 图6查看多版本对象 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002612092117.png "点击放大") #### 使用API [列举桶内对象](https://support.huaweicloud.com/api-obs/obs_04_0022.html) #### 使用SDK | [Java](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1007.html) | [Python](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0806.html) | [C](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0807.html) | [Go](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0407.html) | [BrowserJS](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0907.html) | [.NET](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0807.html) | [Android](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0807.html) | [iOS](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0807.html) | [PHP](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0807.html) | [Node.js](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0807.html) | |---|---|---|---|---|---|---|---|---|---| #### 使用图形化工具OBS Browser+ 1. 登录OBS Browser+。 2. 单击目标桶名称进入对象管理界面，默认显示桶内对象，如[图7]所示。 图7对象列表 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002571109115.png "点击放大") 3. 单击界面中的"版本对象"，会显示桶内版本对象，如[图8]所示。 图8版本对象 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002571109219.png "点击放大") ![](https://support.huaweicloud.com/usermanual-obs/public_sys-resources/note_3.0-zh-cn.png) - 默认列举出来的文件或文件夹只有前100个（按照对象名字典序返回的对象列表），可以通过下拉触底更新下一页的文件或文件夹数量，每次触底更新100个。 - 默认情况下，桶没有设置多版本功能。 ![](https://support.huaweicloud.com/usermanual-obs/public_sys-resources/note_3.0-zh-cn.png) - 默认列举出来的文件或文件夹只有前100个（按照对象名字典序返回的对象列表），可以通过下拉触底更新下一页的文件或文件夹数量，每次触底更新100个。 - 默认情况下，桶没有设置多版本功能。 #### 使用命令行工具obsutil **命令结构** - Windows操作系统 ``` obsutil ls obs://bucket[/prefix] [-s] [-fs] [-d] [-v] [-du] [-marker=xxx] [-versionIdMarker=xxx] [-bf=xxx] [-limit=1] [-format=default] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx] ``` - macOS/Linux操作系统 ``` ./obsutil ls obs://bucket[/prefix] [-s] [-fs] [-d] [-v] [-du] [-marker=xxx] [-versionIdMarker=xxx] [-bf=xxx] [-limit=1] [-format=default] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx] ``` **运行示例** - 示例1：以Windows操作系统为例，运行**obsutil ls obs://bucket-test -limit=10** ，查询桶内对象。 ``` obsutil ls obs://bucket-test -limit=10 Start at 2024-09-30 08:18:50.0592788 +0000 UTC Listing objects . Folder list: obs://bucket-test/api/ Object list: key LastModified Size StorageClass ETag obs://bucket-test/AUTHORS 2018-11-16T02:15:49Z 33243 standard "796393c1eaf502ef56a85c2ceb640aea" obs://bucket-test/CONTRIBUTING.md 2018-11-16T02:15:49Z 1366 standard "12d93325ba6131f852daecd18dd65edc" obs://bucket-test/CONTRIBUTORS 2018-11-16T02:15:49Z 45710 standard "b486b5003e6215c9199e86ab3ccec9fa" obs://bucket-test/LICENSE 2018-11-16T02:15:49Z 1479 standard "5d4950ecb7b26d2c5e4e7b4e0dd74707" obs://bucket-test/PATENTS 2018-11-16T02:15:49Z 1303 standard "3a55d95595a6f9e37dee53826b4daff2" obs://bucket-test/README.md 2018-11-16T02:15:49Z 1399 standard "97351fd7946b9ea021a31a86ba2a10ab" obs://bucket-test/VERSION 2018-11-16T02:15:49Z 7 standard "43d93b553855b0e1fc67e31c28c07b65" obs://bucket-test/api/README 2018-11-16T02:15:49Z 521 standard "4e9e63a87075df60cdf65c8ce9e92117" obs://bucket-test/api/except.txt 2018-11-16T02:15:49Z 20194 standard "8eb96de3f60447e2f09a7531c99fb3ee" Next marker: api/except.txt Folder number: 1 File number: 9 ``` - 示例2：以Windows操作系统为例，运行**obsutil ls obs://bucket-test2** ，查询桶内对象。 ``` obsutil ls obs://bucket-test2 Start at 2024-09-30 08:21:06.6300221 +0000 UTC Listing objects . Object list: key LastModified Size StorageClass ETag obs://bucket-test2/123 2022-03-29T09:17:51Z 0B standard "d41d8cd98f00b204e9800998ecf8427e" obs://bucket-test2/1_2-3.txt 2022-03-29T09:17:51Z 0B standard "d41d8cd98f00b204e9800998ecf8427e" obs://bucket-test2/1_2-3_33.txt 2022-03-29T09:17:51Z 200B standard "dcf204c11d791255adc63e61763c2426" obs://bucket-test2/新建文本文档.txt 2022-03-29T09:17:51Z 0B standard "d41d8cd98f00b204e9800998ecf8427e" Total size of bucket: 200B Folder number: 0 File number: 4 ``` - 示例3：以Windows操作系统为例，运行**obsutil ls obs://bucket-test2/prefix** ，查询桶内以prefix为前缀的对象。 ``` obsutil ls obs://bucket-test2/prefix Start at 2024-09-30 08:24:36.7057148 +0000 UTC Listing objects . Object list: key LastModified Size StorageClass ETag obs://bucket-test2/prefix 2022-03-29T09:17:51Z 0B standard "d41d8cd98f00b204e9800998ecf8427e" obs://bucket-test2/prefix2 2022-03-29T09:17:51Z 0B standard "d41d8cd98f00b204e9800998ecf8427e" Total size of prefix [prefix]:: 0B Folder number: 0 File number: 2 ``` - 更多运行示例，请参见[常见示例](https://support.huaweicloud.com/utiltg-obs/obs_11_0027.html)。 **参数说明** | **参数** | **约束** | **描述** | |:---|:---|:---| | bucket | 必选 | 桶名。 | | prefix | 可选 | 列举对象时的对象名前缀。 说明： 如果为空，则表示列举桶内所有对象。 | | s | 附加参数，可选 | 以精简格式显示查询结果。 说明： 在精简格式下，返回结果只包含对象名。 | | d | 附加参数，可选 | 仅列举当前目录下的对象和子目录，而非递归列举所有对象和子目录。 对于并行文件系统目录，大数据场景下（目录层级深、目录下文件多）的列举，建议使用此参数限制列举范围。 说明： OBS中约定以"/"作为目录分隔符。 | | v | 附加参数，可选 | 列举桶内多版本对象，列举结果包含最新版本的对象和历史版本的对象（如果有）。 | | marker | 附加参数，可选 | 列举桶内对象的起始位置，返回结果是对象名按照字典序排序后该参数以后的所有对象。 说明： 请参考[列举示例](https://support.huaweicloud.com/utiltg-obs/obs_11_0031.html)理解该参数的使用方式。 | | versionIdMarker | 附加参数，可选，必须与v和marker配合使用 | 列举桶内多版本对象的起始位置，返回结果是对象名和版本号按照字典序排序后该参数以后的所有对象。 说明： 如果versionIdMarker不是marker的一个版本号，则该参数无效。 | | bf | 附加参数，可选 | 列举结果中字节数的显示格式。支持的值： - human-readable - raw 说明： 如果未设置该参数，则列举结果中字节数的显示格式由配置文件中的humanReadableFormat参数决定。 | | du | 附加参数，可选 | 快速返回所列举对象的总大小，不显示具体的对象信息，可与其他参数配合使用。 说明： 如果所列举对象过多，需稍候。 注意： Util 5.4.6 版本及以上支持该参数。 | | fs | 附加参数，可选 | 是否使用并行文件系统的列举方式，如果桶是并行文件系统，推荐加上该参数。 注意： - 该列举方式会因为目录结构，耗时会差别很大。 - 该参数开启后，会忽略marker和limit值，统计桶或者并行文件系统或者指定目录的大小。 - Util 5.5.12版本及以上支持该参数。 | | limit | 附加参数，可选 | 列举结果的最大个数，小于等于0表示列举所有结果，不设置时的默认值为1000。 说明： 如果桶内对象较多，建议设置该值限制每次列举的对象个数，列举结束后，如果仍有对象，会在结果中返回下次请求的marker和versionIdMarker，用于继续列举剩余的对象。 | | format | 附加参数，可选 | 指定以自定义格式打印列举结果。当前仅支持值\[default\]，指定列举结果在一行显示。 | | bucket-cname | 附加参数，可选 | 指定桶绑定的自定义域名 说明： Util 5.7.9版本及以上支持该参数。 | | config | 附加参数，可选 | 运行当前命令时的自定义配置文件。可支持的配置参数请参考[配置参数说明](https://support.huaweicloud.com/utiltg-obs/obs_11_0035.html)。 | | e | 附加参数，可选 | 指定终端节点。 | | i | 附加参数，可选 | 指定用户的AK。 | | k | 附加参数，可选 | 指定用户的SK。 | | t | 附加参数，可选 | 指定用户的securitytoken。 | **响应结果** 执行列举多版本对象命令后，在响应结果中，多版本对象和带删除标记的对象会分开展示，如[图9]所示。 图9列举多版本对象响应结果 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002655540705.png "点击放大") ``` obsutil ls obs://no-delete-bucket-version-obsutil/data_0001.txt -v Start at 2026-06-17 01:23:35.2387286 +0000 UTC Listing versioning objects . Versioning Object list: Key VersionId LastModified Size StorageClass ETag obs://no-delete-bucket-version-obsutil/data_0001.txt G001119ED0A0BF6800004017005E42D5 2026-06-16T13:30:56Z 0B standard "d41d8cd98f00b204e9800998ecf8427e" DeleteMarker list: Key VersionId LastModified StorageClass obs://no-delete-bucket-version-obsutil/data_0001.txt G001119ED32CD9F700004011024A1A22 2026-06-17T01:23:12Z standard Total size of prefix [data_0001.txt]: 0B Folder number: 0 Versioning file number: 1 DeleteMarker number: 1 ``` 表1Object list和Versioning Object list响应结果参数说明（普通对象和多版本对象） | **字段名** | **描述** | |:---|:---| | Key | 对象名。 | | VersionId | 对象的版本ID。如果桶开启或暂停多版本控制，列举桶内多版本对象时，响应结果会展示该参数。 | | LastModified | 对象的最近一次修改时间。 | | Size | 对象的大小。 | | StorageClass | 对象的存储类型。支持的值： - standard：标准存储，访问时延低、吞吐量高，适用于有大量热点文件（平均一个月多次）或小文件（小于1MB）。 - warm：低频访问存储，可用性略低于standard，适用于不频繁访问（平均一年少于12次）但在需要时也要求快速访问数据的业务场景。 - cold：归档存储，安全、持久且成本极低，适用于很少访问（平均一年访问一次）数据的业务场景。 - deep-archive：深度归档存储，适用于长期不访问（平均几年访问一次）数据的业务场景，其成本相比归档存储更低，但相应的数据恢复时间将更长，一般为数小时。 | | ETag | 对象的ETag值。对象的base64编码的128位MD5摘要。ETag可用于校验对象内容是否发生变化，但不能作为对象的唯一标识。比如上传对象时ETag为A，下载对象时ETag为B，则说明对象内容发生了变化。ETag只反映变化的内容，而不是其元数据。上传的对象或拷贝操作创建的对象，都有唯一的ETag。 | 表2DeleteMarker list响应结果参数说明（删除标记） | **字段名** | **描述** | |:---|:---| | Key | 对象名。 | | VersionId | 对象的版本ID。如果桶开启或暂停多版本控制，列举桶内多版本对象时，响应结果会展示该参数。 | | LastModified | 对象的最近一次修改时间。 | | StorageClass | 对象的存储类型。支持的值： - standard：标准存储，访问时延低、吞吐量高，适用于有大量热点文件（平均一个月多次）或小文件（小于1MB）。 - warm：低频访问存储，可用性略低于standard，适用于不频繁访问（平均一年少于12次）但在需要时也要求快速访问数据的业务场景。 - cold：归档存储，安全、持久且成本极低，适用于很少访问（平均一年访问一次）数据的业务场景。 - deep-archive：深度归档存储，适用于长期不访问（平均几年访问一次）数据的业务场景，其成本相比归档存储更低，但相应的数据恢复时间将更长，一般为数小时。 |