设置可维护时间段-ConfiguringtheMaintenanceWindow
接口说明
修改用户允许启动某项对数据库实例运行有影响的任务的时间范围，例如操作系统升级和数据库软件版本升级的时间窗。
调试
您可以在API Explorer中调试该接口。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
dds:instance:updateOpsWindow
write
instance
dds:instance:modify
-
URI
- URI格式
PUT /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，可以调用“查询实例列表和详情-QueryingInstancesandDetails”接口获取。如果未申请实例，可以调用“创建实例-CreatingaDBInstance”接口创建。
约束限制：
不涉及。
取值范围：
不涉及。
默认取值：
不涉及。
请求消息
- 参数说明
表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.
响应示例
无
状态码
详情请参见状态码。
错误码
详情请参见错误码。
