Help Center/ Object Storage Service/ SDK Reference/ Go/ Before You Start (SDK for Go)
Updated on 2026-11-09 GMT+08:00

Before You Start (SDK for Go)

This section describes the version updates, compatibility, and important notes about Object Storage Service (OBS) SDK for Go.

Version Updates and Compatibility

Table 1 describes the version updates and compatibility of OBS SDK for Go.

Table 1 Version updates and compatibility of OBS SDK for Go

Version

Update

Description

Compatible or Not

v3.26.6

  • New features
  • Document optimization

New features:

Document optimization:

Yes

v3.26.3

New features

  • Object tagging: Added APIs related to object tagging to help data classification and management.
  • Bucket encryption configuration: Supported the encryption configuration during bucket creation to improve data security.

Yes

v3.25.9

Fixed issues

Fixed the issue that the first byte cannot be downloaded when a range is specified.

Yes

v3.25.4

New features

Supported the transfer of metadata when the UploadFile method is used.

Yes

v3.25.3

New features

  • Added APIs related to Block Public Access (BPA).
  • Supported Intelligent Tiering.

Yes

v3.24.9

New features

Added the listPosixObject API.

Yes

v3.24.6

  • New features
  • Fixed issues

New features:

  • Supported the transfer of metadata when the CopyObject and InitiateMultipartUpload methods are used.

Fixed issues:

  • Fixed the issue that the bucket ACL fails to be configured in some scenarios.
  • Fixed the issue that data transmission is abnormal in the retry scenario.

Yes

v3.24.3

New features

Added APIs related to access labels.

Yes

v3.23.4

New features

  • Added obs.WithCustomHeader that allows you to add custom headers in the requests of clients interacting with OBS.
  • Supported custom bucket domain names, with the SetBucketCustomDomain, GetBucketCustomDomain, and DeleteBucketCustomDomain APIs added.
  • Supported mirroring-based back to source, with the SetBucketMirrorBackToSource, GetBucketMirrorBackToSource, and DeleteBucketMirrorBackToSource APIs added.

Yes

3.23.3

New features

Added obs.WithCallbackHeader that allows you to configure callback parameters in object upload requests.

Yes

3.22.11

Code optimization

Optimized the OBS SDK for Go code.

Yes

3.21.12

New features

Added obs.WithTrafficLimitHeader that limits the bandwidth for a single connection.

Yes

Earlier than 3.21.12

-

End of matching. You are advised to upgrade the version.

-

Important Notes

  • Make sure that you are familiar with basic OBS concepts, such as buckets, objects, access keys (AKs/SKs), and endpoints and domain names.
  • Some features are available only for some regions. If 405 HTTP status code is returned for a certain feature API, check whether the region supports that feature. For details, refer to Functions or submit a service ticket to contact technical support.
  • Namespace: obs is used as the namespace to be compatible with earlier OBS 2.0 versions (2.2.x). All data types and API definitions contained in the SDK belong to this namespace. Before using OBS SDK for Go, you need to import obs.
  • API functions are compatible with earlier OBS 2.0 versions (2.2.x).