# 使用前须知(Go SDK) ![](https://support.huaweicloud.com/sdk-go-devg-obs/public_sys-resources/note_3.0-zh-cn.png) OBS SDK合规使用指南请[单击此处](https://github.com/huaweicloud/huaweicloud-sdk-go-obs/blob/master/开发者合规指南.md)；OBS SDK隐私声明请[单击此处](https://github.com/huaweicloud/huaweicloud-sdk-go-obs/blob/master/隐私政策声明.md)。 本文介绍Go SDK的版本变更，并提供版本兼容性说明，以及其他使用前须知。 #### 版本变更及兼容性说明 如[表1]所示，本节将为您展示Go SDK的版本变更情况和兼容性说明。 表1Go SDK版本变更及兼容性说明 | **版本** | **变更类型** | **说明** | **是否兼容** | |:---|:---|:---|:---| | v3.26.6 | - 新功能 - 文档优化 | 新增功能： - [支持上传对象时设置回调参数，并将回调结果返回给用户](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0605.html) - [支持通过HeadObject接口检查指定桶中是否存在指定的对象](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0518.html) - [支持获取上传对象的进度](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_0610.html) - [支持获取下载对象的进度](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0623.html) - [支持列举并行文件系统内的对象](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_3903.html) 文档优化： - [优化创建并行文件系统的内容](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_1901.html) - [补充该场景的代码示例：生成在单链接限速场景里下载对象的带授权信息的URL，并下载对象](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0601.html) - [补充该场景的代码示例：生成在单链接限速场景里下载指定版本对象的带授权信息的URL，并下载对象](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0601.html) - [优化有关设置对象元数据相关参数](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0920.html) | 是 | | v3.26.3 | 新功能 | - 对象标签： 新增对象标签（Object Tagging）相关接口，支持对数据的分类管理。 - 桶加密配置： 创建桶（Bucket）时支持自主配置加密方式，提升数据安全性。 | 是 | | v3.25.9 | 问题修复 | 修复range无法下载首字节的问题。 | 是 | | v3.25.4 | 新功能 | 支持在使用UploadFile方法时传递元数据信息。 | 是 | | v3.25.3 | 新功能 | - 新增BPA相关接口。 - 支持智能分级特性。 | 是 | | v3.24.9 | 新功能 | 新增listPosixObject接口。 | 是 | | v3.24.6 | - 新功能 - 问题修复 | 新功能： - 支持在使用CopyObject和InitiateMultipartUpload方法时传递元数据信息。 问题修复： - 修复部分场景下bucket acl配置失败的问题。 - 修复重试场景下数据传输异常的问题。 | 是 | | v3.24.3 | 新功能 | 新增accesslabel相关接口。 | 是 | | v3.23.4 | 新功能 | - 增加obs.WithCustomHeader方法，支持在与OBS云服务交互的用户端请求头域中，增加自定义header头域 - 新增支持桶自定义域名功能，包括SetBucketCustomDomain、GetBucketCustomDomain和DeleteBucketCustomDomain三个自定义域名相关接口。 - 新增支持桶镜像回源功能，包括SetBucketMirrorBackToSource、GetBucketMirrorBackToSource和DeleteBucketMirrorBackToSource三个镜像回源相关接口。 | 是 | | v3.23.3 | 新功能 | 增加obs.WithCallbackHeader方法，支持在上传对象请求中设置回调参数。 | 是 | | v3.22.11 | 代码优化 | 优化Go SDK代码。 | 是 | | v3.21.12 | 新功能 | 新增obs.WithTrafficLimitHeader接口，此接口用于限制单个连接的带宽。 | 是 | | 低于v3.21.12（停止配套，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，请确认该区域是否支持该功能特性。您可以查看[产品功能](https://support.huaweicloud.com/productdesc-obs/obs_03_0151.html)确认区域是否支持该功能特性，或者[提交工单](https://console.huaweicloud.com/ticket/#/ticketindex/createIndex)寻求技术支持。 - 命名空间：与OBS 2.0 旧版本（2.2.x）保持兼容，使用**obs** 作为命名空间，SDK包含的所有数据类型和接口定义均归属于该命名空间，使用SDK前需要引入**obs**。 - 接口函数：与OBS 2.0 旧版本（2.2.x）保持兼容。