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

设置可维护时间段

接口说明

修改用户允许启动某项对数据库实例运行有影响的任务的时间范围,例如操作系统升级和数据库软件版本升级的时间窗。

URI

  • URI格式
    PUT https://{Endpoint}/v3/{project_id}/instances/{instance_id}/maintenance-window
    表1 路径参数

    参数

    是否必选

    参数类型

    描述

    project_id

    String

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

    instance_id

    String

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

表3 请求Body参数

参数

是否必选

参数类型

描述

start_time

String

开始时间,格式必须为HH:MM且有效,当前时间指UTC时间。不能与结束时间相同,只能为整点。

end_time

String

结束时间,格式必须为HH:MM且有效,当前时间指UTC时间。不能与开始时间相同,只能为整点。

  • 请求示例

    设置可维护时间段。

    { 
      "start_time" : "14:00", 
      "end_time" : "15:00" 
    }

响应参数

响应示例

状态码

详情请参见状态码

错误码

详情请参见错误码