更新静默策略
接口说明
更新指定静默策略的配置。maintainWindowName 为空时保留原名称;description、filterSetting、effective、effectTimeRange、startTime、endTime 按请求体中的值更新,未提供时写为空。建议先通过 GetMaintainWindow 获取当前配置后再提交修改。
本接口不修改策略的启用状态,启用或暂停请使用 EnableMaintainWindow、DisableMaintainWindow。时间配置校验与 CreateMaintainWindow 一致;同一工作空间下策略名称重复时返回 InvalidParameterValue;指定的静默策略不存在时返回 ResourceNotFound。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
PUT /maintainWindows/{maintainWindowId} HTTP/1.1
路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| maintainWindowId |
string |
是 |
静默策略 ID。创建静默策略时若未指定则由系统生成,可通过 ListMaintainWindows 查询。 |
3ff3fbd0-8a0b-4b31-9b1c-8e3f0a2c5d71 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| workspace |
string |
否 |
工作空间名称。后端要求必填,用于隔离不同业务空间的静默策略资源。 |
default-cms-xxxx-cn-hangzhou |
| body | MaintainWindowForModify |
否 |
请求体,后端要求必填;请传入完整的 MaintainWindowForModify 配置对象。 |
请求体为 MaintainWindowForModify 结构:maintainWindowName 为空时保留原名称;description 为策略描述,长度不超过 120 个字符;filterSetting 定义命中事件的过滤条件;startTime、endTime 定义一次性生效区间(毫秒时间戳);effective 为 Crontab 表达式;effectTimeRange 定义周期性生效时段(dayInWeek 取值 0~6,0 表示周日;startTimeInMinute、endTimeInMinute 为当天的分钟数,不支持跨天)。除 maintainWindowName 外,未提供的配置字段会写为空。
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
响应内容结构。 |
||
| maintainWindowId |
string |
已更新的静默策略 ID。 |
3ff3fbd0-8a0b-4b31-9b1c-8e3f0a2c5d71 |
| requestId |
string |
本次请求的唯一 ID,用于问题排查与工单定位。 |
0CEC5375-C554-562B-A65F-9A629907C1F0 |
示例
正常返回示例
JSON格式
{
"maintainWindowId": "3ff3fbd0-8a0b-4b31-9b1c-8e3f0a2c5d71",
"requestId": "0CEC5375-C554-562B-A65F-9A629907C1F0"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidParameterValue | Illegal parameters. | 参数错误。 |
| 500 | InternalUnknownError | The request processing has failed due to some unknown error. | 服务运行错误。 |
| 403 | Forbidden | You are not authorized to operate the specified resource. | 没有权限,请使用RAM进行授权 |
| 404 | ResourceNotFound | The specified resource is not found. | 未找到指定资源。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。