文档首页/ 文档数据库服务 DDS/ API参考/ API v3（推荐）/ 实例管理/ 设置可维护时间段
更新时间：2025-08-22 GMT+08:00
查看PDF
分享

设置可维护时间段

接口说明

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

URI

  • URI格式

    PUT https://{Endpoint}/v3/{project_id}/instances/{instance_id}/maintenance-window

  • URI样例
    https://dds.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/054e292c9880d4992f02c0196d3ein02/maintenance-window
    表1 路径参数

    参数

    是否必选

    参数类型

    描述

    project_id

    是

    String

    参数解释：

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

    约束限制：

    不涉及。

    取值范围：

    不涉及。

    默认取值：

    不涉及。

    instance_id

    是

    String

    参数解释：

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

    约束限制：

    不涉及。

    取值范围：

    不涉及。

    默认取值：

    不涉及。

请求消息

  • 参数说明
    表2 请求Header参数

    参数

    是否必选

    参数类型

    描述

    X-Auth-Token

    是

    String

    参数解释：

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

    约束限制：

    不涉及。

    取值范围：

    不涉及。

    默认取值：

    不涉及。
    表3 请求Body参数

    参数

    是否必选

    参数类型

    描述

    start_time

    是

    String

    参数解释：

    开始时间。

    约束限制：

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

    取值范围：

    不涉及。

    默认取值：

    不涉及。

    end_time

    是

    String

    参数解释：

    结束时间。

    约束限制：

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

    取值范围：

    不涉及。

    默认取值：

    不涉及。

请求示例

设置可维护时间段

PUT https://dds.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/054e292c9880d4992f02c0196d3ein02/maintenance-window 
{ 
  "start_time" : "14:00",
  "end_time" : "15:00"
}

响应参数

状态码：204

No Content.

响应示例

无

状态码

详情请参见状态码。

错误码

详情请参见错误码。

父主题： 实例管理