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

批量数据库补丁升级

功能介绍

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

接口约束

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

调试

您可以在API Explorer中调试该接口。

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

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

状态码： 400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

状态码： 500

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

请求示例

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

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.

错误码

详情请参见错误码。

父主题： 实例管理

相关文档