文档首页/ 对象存储服务 OBS/ SDK参考/ Go/ 使用前须知(Go SDK)
更新时间：2024-12-09 GMT+08:00
查看PDF
分享

使用前须知(Go SDK)

本文介绍Go SDK的版本变更，并提供版本兼容性说明，以及其他使用前须知。

变更及兼容性说明

如表1所示，本节将为您展示Go SDK的版本变更情况和兼容性说明。

表1 Go SDK版本变更及兼容性说明

版本

变更类型

说明

是否兼容

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）、对象（Object）、访问密钥（AK和SK）、终端节点（Endpoint）和访问域名等。
  • 当前各区域特性开放不一致，部分特性只在部分区域开放，使用过程中如果接口HTTP状态码为405，请确认该区域是否支持该功能特性。您可以查看功能总览确认区域是否支持该功能特性，或者提交工单寻求技术支持。
  • 命名空间：与OBS 2.0 旧版本（2.2.x）保持兼容，使用obs作为命名空间，SDK包含的所有数据类型和接口定义均归属于该命名空间，使用SDK前需要引入obs。
  • 接口函数：与OBS 2.0 旧版本（2.2.x）保持兼容。