Help Center/ Object Storage Service/ SDK Reference/ Python/ Before You Start (SDK for Python)
Updated on 2026-07-31 GMT+08:00

Before You Start (SDK for Python)

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

Version Updates and Compatibility

Table 1 describes the version updates and compatibility with earlier versions of OBS SDK for Python. For details about the version revision records, see ChangeLog.

Table 1 Version updates and compatibility of OBS SDK for Python

Version

Update

Description

Compatible or Not

V3.26.6 (latest and recommended)

  • New features
  • Document optimization

New features:

Document optimization:

Yes

v3.26.2

Resolved issues

  • Fixed the issue that an error is reported when CRC64 verification is enabled for the putContent API to upload empty objects.
  • Updated some MIME mappings and added the MIME mapping for WASM files.

Yes

v3.25.8

  • New features
  • Resolved issues
  • Compatibility changes

New features:

  • When an ECS agency is used to initialize ObsClient, the more secure IMDSv2 API is preferentially used to interact with ECS.

Resolved issues:

  • Fixed the issue that the retry cannot be performed if verification fails after CRC64 verification and resumable upload are enabled for the ObsClient.downloadFile API.

Compatibility changes:

  • Python 2 is no longer supported. Use Python 3.6 or later.

Yes

v3.25.3

New features

Allowed you to use APIs related to custom domain names.

Yes

v3.24.12

New features

Allowed you to use APIs related to BPA.

Yes

v3.24.6.1

New features

Supported CRC64 verification.

Yes

v3.24.3

Resolved issues

Optimized some code.

Yes

v3.23.12

Resolved issues

  • Resolved the issue of inconsistent contentType when uploading a folder using putFile.

Yes

v3.23.9.1

  • New features
  • Resolved issues

Yes

Versions earlier than v3.23.9.1 (EOM)

-

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 in some regions. If 405 HTTP status code is returned for a call of a certain feature API, check whether the region supports this feature.
  • The namespace is incompatible with earlier OBS versions (2.1.x). All modules are saved in the obs package.
  • API functions are compatible with earlier OBS versions (2.1.x).