版本控制
更新时间：2026-09-23
概述
版本控制功能为您提供 Bucket 级别的数据保护能力。当您开启版本控制后，对文件的删除及覆盖操作将生成新的版本而不会对原有文件产生影响。当您需要恢复数据时，可将任意历史版本恢复到当前版本。
注意事项
- 当前仅支持广州和北京地域开启版本控制，北京地域需要申请功能白名单。
- 版本控制功能开启后只可切换至暂停状态，无法关闭。
- 当前未支持归档类型文件的版本控制，默认存储类型为归档类型的 Bucket 不允许开启版本控制。Bucket 开启版本控制后将无法上传或转换成归档类型的文件，删除操作也将直接删除归档类型文件的数据。
- append 类型的文件追加写时不会产生新的版本。
- 功能选项中如果没有历史版本的选项，默认仅对最新版本进行操作。
- 产品功能说明详见版本控制概述 。
代码示例
运行以下示例前，请先参考初始化完成 BOS Client 初始化，并将示例中的 bucket_name（及其它占位符）替换为实际值。
开启/关闭版本控制
Python
1from baidubce.services.bos import common
2
3bucket_name = 'example-bucket-name'
4# common.ENABLED：开启，common.SUSPENDED：暂停，common.DISABLED：关闭
5res = bos_client.put_bucket_versioning(bucket_name, common.ENABLED)查看版本控制
Python
1bucket_name = 'example-bucket-name'
2res = bos_client.get_bucket_versioning(bucket_name)
3print("get bucket versioning status is %s" % res.status)评价此篇文章