文档首页/ 文档数据库服务 DDS/ API参考/ API v3（推荐）/ 实例管理/ 批量数据库补丁升级
更新时间：2025-08-22 GMT+08:00
查看PDF
分享

批量数据库补丁升级

功能介绍

批量升级数据库补丁版本。

接口约束

  • 只支持即时升级，请选择在业务低峰期进行升级。
  • 只支持“升级时长最短优先模式”升级模式。

URI

POST https://{Endpoint}/v3/{project_id}/instances/db-upgrade
表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

租户在某一region下的project ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

从IAM服务获取的用户Token。请参考认证鉴权。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表3 请求Body参数

参数

是否必选

参数类型

描述

instance_ids

是

Array of strings

参数解释：

指定需要升级数据库补丁版本的实例ID列表。

约束限制：

一次最多可传入10个实例ID。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码： 202

表4 响应Body参数

参数

参数类型

描述

upgrade_results

Array of objects

参数解释：

批量升级结果。详情请参见表5。

取值范围：

不涉及。
表5 UpgradeResult

参数

参数类型

描述

job_id

String

参数解释：

任务ID。仅当补丁版本升级任务提交成功时返回该字段。

取值范围：

不涉及。

instance_id

String

参数解释：

实例ID。

取值范围：

不涉及。

error_code

String

参数解释：

错误码。仅当补丁版本升级任务提交失败时返回该字段。

取值范围：

不涉及。

error_message

String

参数解释：

失败原因。仅当补丁版本升级任务提交失败时返回该字段。

取值范围：

不涉及。

请求示例

  • URI样例 
    POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/db-upgrade
  • 批量升级数据库补丁版本。 
    { 
  "instance_ids" : [ "046287aae57843b1a7bc61b7a8812f41in02", "3d1e04f49efa473a8c7eaf07ed7ff870in02" ] 
}

响应示例

状态码： 202

Accepted.

{ 
  "upgrade_results" : [ { 
    "instance_id" : "046287aae57843b1a7bc61b7a8812f41in02", 
    "job_id" : "e4616470-733d-41de-a9b0-a260709293d3" 
  }, { 
    "instance_id" : "3d1e04f49efa473a8c7eaf07ed7ff870in02", 
    "error_code" : "DBS.200011", 
    "error_message" : "The status of DB instance does not allow the operation." 
  } ] 
}

状态码

状态码

描述

202

Accepted.

400

Client error.

500

Server error.

错误码

详情请参见错误码。

父主题： 实例管理