文档首页/ 文档数据库服务 DDS/ API参考/ API v3(推荐)/ 实例管理/ 查询数据库补丁升级预估时长
更新时间:2025-08-22 GMT+08:00

查询数据库补丁升级预估时长

接口说明

查询数据库补丁升级预估时长。

URI

  • URI格式

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

  • URI样例
    https://dds.cn-north-1.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/{instance_id}/db-upgrade-duration
    表1 请求参数

    参数

    是否必选

    参数类型

    描述

    X-Auth-Token

    String

    参数解释:

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

    约束限制:

    不涉及。

    取值范围:

    不涉及。

    默认取值:

    不涉及。

    project_id

    String

    参数解释:

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

    约束限制:

    不涉及。

    取值范围:

    不涉及。

    默认取值:

    不涉及。

    instance_id

    String

    参数解释:

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

    约束限制:

    不涉及。

    取值范围:

    不涉及。

    默认取值:

    不涉及。

请求消息

无。

响应消息

  • 参数说明
    表2 响应Body参数

    参数

    参数类型

    说明

    strategies

    Array of 表3 objects

    参数解释:

    升级策略列表。

    取值范围:

    不涉及。

    表3 DurationStrategies

    参数

    参数类型

    说明

    strategy

    String

    参数解释:

    升级策略。

    取值范围:

    • minimized_interrupt_time,表示最短中断时。
    • minimized_upgrade_time,最短升级时长。

    estimated_upgrade_duration

    Integer

    参数解释:

    升级时长,单位为分钟。

    取值范围:

    不涉及。

请求示例

GET https://{endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/{instance_id}/db-upgrade-duration

响应示例

状态码:200

Success.

{    
  "strategies" : [ {     
  "strategy" : "minimized_interrupt_time",   
  "estimated_upgrade_duration" : 10   
  }, {     
    "strategy" : "minimized_upgrade_time",   
    "estimated_upgrade_duration" : 5  
  } ]  
}

状态码

详情请参见状态码

错误码

详情请参见错误码