# 使用前须知(Python SDK) ![](https://support.huaweicloud.com/sdk-python-devg-obs/public_sys-resources/note_3.0-zh-cn.png) OBS SDK合规使用指南请[单击此处](https://github.com/huaweicloud/huaweicloud-sdk-python-obs/blob/master/开发者合规指南.md)；OBS SDK隐私声明请[单击此处](https://github.com/huaweicloud/huaweicloud-sdk-python-obs/blob/master/隐私政策声明.md)。 本文介绍Python SDK的版本变更，并提供版本兼容性说明，以及其他使用前须知。 #### 变更及兼容性说明 如[表1]所示，本节将为您展示Python SDK的版本变更情况，以及当前版本是否兼容某个历史版本的说明，更多版本修订信息请参见：[ChangeLog](https://github.com/huaweicloud/huaweicloud-sdk-python-obs/blob/master/README_CN.md)。 表1Python SDK版本变更及兼容性说明 | **版本** | **变更类型** | **说明** | **是否兼容** | |:---|:---|:---|:---| | V3.26.6（最新版本）（推荐版本） | - 新功能 - 文档优化 | 新增功能： - [支持配置桶清单](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_3001.html)。 - [支持配置在线解压策略](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_3014.html)。 - [支持并行文件系统修改写对象](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0997.html)。 - [支持配置对象标签](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_3000.html)。 - [支持配置桶级默认WORM策略](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_3018.html)。 - [支持配置桶DIS策略](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_3010.html)。 - [支持配置桶归档直读策略](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_3006.html)。 文档优化： - [补充异步断点续传上传、暂停和取消的代码示例](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0905.html)。 - [优化桶加密内容，通过指定加密方式加密桶](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0838.html)。 - [优化桶自定义域名里有关证书托管的内容](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0851.html)。 - [补充使用MD5校验文件一致性文档](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0928.html)。 - [补充恢复指定路径下的对象的代码示例](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0924.html)。 - [补充统计文件夹大小的代码示例](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0805.html)。 - [补充多段复制的代码示例](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1007.html)。 - [补充创建桶时开启WORM开关的代码示例](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1305.html)。 - [补充下载对象时指定多个范围的代码示例](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0911.html)。 - [补充临时url指定版本号下载对象的代码示例](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1301.html)。 - [补充断点续传上传回调的代码示例](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1305.html)。 | 是 | | v3.26.2 | 问题修复 | - 修复putContent接口开启crc64校验上传空对象报错的问题。 - 更新部分MIME映射，并新增支持wasm文件的MIME映射。 | 是 | | v3.25.8 | - 新功能 - 修复问题 - 兼容性变更 | 新增功能： - 使用ECS委托初始化ObsClient时会优先使用更安全的IMDSv2接口与ECS服务交互。 修复问题： - 修复ObsClient.downloadFile接口开启crc64和断点续传后，如果校验失败，无法重试的问题。 兼容性变更 - 不再支持python2，请使用python3.6及以上版本。 | 是 | | v3.25.3 | 新功能 | 支持自定义域名相关接口 | 是 | | v3.24.12 | 新功能 | 支持BPA相关接口。 | 是 | | v3.24.6.1 | 新功能 | 支持crc64校验。 | 是 | | v3.24.3 | 问题修复 | 优化部分代码实现。 | 是 | | v3.23.12 | 问题修复 | - 修复putFile上传文件夹时可能导致contentType不一致问题。 | 是 | | v3.23.9.1 | - 新功能 - 问题修复 | - [设置桶的生命周期配置(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0821.html)支持设置桶碎片的过期时间。 - 修复上传重试时可能报read of closed file问题。 | 是 | | 低于v3.23.9.1（停止配套，EOM） | - | 版本过低，已停止维护，建议及时升级版本。 | - | #### 其他使用前须知 - 请确认您已经熟悉OBS的基本概念，如[桶（Bucket）](https://support.huaweicloud.com/productdesc-obs/obs_03_0207.html)、[对象（Object）](https://support.huaweicloud.com/productdesc-obs/obs_03_0206.html)、[访问密钥（AK和SK）](https://support.huaweicloud.com/productdesc-obs/obs_03_0208.html)、[终端节点（Endpoint）和访问域名](https://support.huaweicloud.com/productdesc-obs/obs_03_0152.html)等。 - 当前各区域特性开放不一致，部分特性只在部分区域开放，使用过程中如果接口HTTP状态码为405，请确认该区域是否支持该功能特性。 - 命名空间：与旧版本（2.1.x）不兼容，所有模块都调整到obs包下。 - 接口函数：与旧版本（2.1.x）保持兼容。