更新时间:2026-01-07 GMT+08:00

数据库补丁升级

接口说明

升级数据库补丁版本。

约束说明

  • 冻结实例、异常实例,无法升级补丁版本。
  • 实例中存在异常节点,无法升级补丁版本。
  • 请根据查询实例列表和详情接口返回结果中的“patch_available”字段判断是否支持升级。
  • 请选择在业务低峰期进行升级。

URI

  • URI格式
    POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/db-upgrade
    表1 路径参数

    参数

    是否必选

    参数类型

    描述

    project_id

    String

    租户在某一region下的project ID。请参考获取项目ID章节获取项目编号。

    instance_id

    String

    实例ID,可以调用“查询实例列表和详情”接口获取。如果未申请实例,可以调用“创建实例”接口创建。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

表3 请求Body参数

参数

是否必选

参数类型

描述

upgrade_mode

String

升级模式。取值为“minimized_interrupt_time”为中断时间最短优先模式:升级过程对业务影响相对较小的升级方式取值为“minimized_upgrade_time”为升级时长最短优先模式:升级过程时长相对较快的升级方式。默认取值为“minimized_interrupt_time”。

  • 请求示例

    副本集实例升级数据库补丁版本。

    { 
      "upgrade_mode" : "minimized_interrupt_time" 
    }

响应参数

表4 响应Body参数

参数

参数类型

描述

job_id

String

任务ID。

  • 响应示例
    { 
      "job_id" : "55e166d2-83ad-425f-b887-3503de03dc9b" 
    }

状态码

详情请参见状态码

错误码

详情请参见错误码