Help Center/ Object Storage Service/ SDK Reference/ Go/ Before You Start (SDK for Go)

Updated on 2024-12-09 GMT+08:00

View PDF

Before You Start (SDK for Go)

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

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
3.23.4 (the latest version)	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.	-
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.	-

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 Function Overview 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).