更新时间：2025-09-08 GMT+08:00
使用前须知(Java SDK)
本文介绍Java SDK的版本变更，并提供版本兼容性说明，以及其他使用前须知。
变更说明
如表1所示，本节将为您展示Java SDK的版本变更情况和兼容性说明。
|
版本 |
变更类型 |
说明 |
是否兼容 |
|---|---|---|---|
|
新功能 |
新功能：支持IMDSv2 |
是 |
|
|
新功能 问题修复和优化 |
新功能：
问题修复和优化：
|
是 |
|
|
新功能 |
新功能：
|
是 |
|
|
问题修复和优化 |
问题修复和优化：
|
是 |
|
|
新功能 问题修复和优化 适配第三方组件 |
新功能：
问题修复和优化：
适配第三方组件：
|
是 |
|
|
问题修复和优化 适配第三方组件 |
问题修复和优化：
适配第三方组件：
|
是 |
|
|
新功能 适配第三方组件 |
|
是 |
|
|
新功能 适配第三方组件 |
新功能：
适配第三方组件：
|
是 |
|
|
新功能 |
新功能：
|
是 |
|
|
新功能 适配第三方组件 |
新功能：
适配第三方组件：
|
是 |
|
|
新功能 适配第三方组件 |
新功能：
适配第三方组件：
|
是 |
|
|
低于v3.22.12（停止配套，EOM） |
- |
版本过低，已停止维护，建议及时升级版本。 |
- |
完整的版本变更情况请参见：ChangeLog。
兼容性说明
- 推荐使用的JDK版本：JDK 8及以上版本。
- 旧版本（2.x）已不再维护，建议尽快升级至最新版。
其他使用前须知
- 本文档是与OBS SDK配套的参考文档，为了您能更好的使用Java SDK，推荐前往下载与安装SDK(Java SDK)下载最新版本的Java SDK。
- 请确认您已经熟悉OBS的基本概念，如桶（Bucket）、对象（Object）、访问密钥（AK和SK）、终端节点（Endpoint）和访问域名等。
- 您可以先参考OBS客户端通用示例，了解OBS Java SDK接口调用的通用方式。
- 使用OBS客户端进行接口调用操作完成后，没有异常抛出，则表明返回值有效；如果抛出异常，则说明操作失败，此时可从SDK自定义异常实例中获取错误信息。
- 使用OBS客户端进行接口调用成功后，均会返回包含响应头信息的SDK公共响应头实例（或其子类实例）。
- 当前各区域特性开放不一致，部分特性只在部分区域开放，使用过程中如果接口HTTP状态码为405，请确认该区域是否支持该功能特性。您可以查看功能总览确认区域是否支持该功能特性，或者提交工单寻求技术支持。
