数据库补丁升级

接口说明

升级数据库补丁版本。

约束说明

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

调试

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

URI

• URI格式

  POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/db-upgrade

• URI样例
  https://dds.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/054e292c9880d4992f02c0196d3ein02/db-upgrade

  表1 请求参数

  参数	是否必选	参数类型	描述
  project_id	是	String	租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。
  instance_id	是	String	实例ID，可以调用“查询实例列表和详情”接口获取。如果未申请实例，可以调用“创建实例”接口创建。

请求消息

• 请求参数

  表2 请求Header参数

  参数	是否必选	参数类型	描述
  X-Auth-Token	是	String	从IAM服务获取的用户Token。请参考认证鉴权。

  表3 请求Body参数

  参数	是否必选	参数类型	描述
  upgrade_mode	否	String	升级模式。取值为“minimized_interrupt_time”为中断时间最短优先模式：升级过程对业务影响相对较小的升级方式取值为“minimized_upgrade_time”为升级时长最短优先模式：升级过程时长相对较快的升级方式。默认取值为“minimized_interrupt_time”。

请求示例

副本集实例升级数据库补丁版本，升级模式为中断时间最短优先模式

POST https://dds.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/054e292c9880d4992f02c0196d3ein02/db-upgrade 
 
{ 
  "upgrade_mode" : "minimized_interrupt_time" 
}

响应消息

• 参数说明

  表4 响应Body参数

  参数	参数类型	描述
  job_id	String	任务ID。

• 响应示例

  { 
    "job_id" : "55e166d2-83ad-425f-b887-3503de03dc9b" 
  }

状态码

详情请参见状态码。

错误码

详情请参见错误码。