UpdateMaintainWindow - 更新静默策略

更新时间:
复制 MD 格式

更新静默策略

接口说明

更新指定静默策略的配置。maintainWindowName 为空时保留原名称;description、filterSetting、effective、effectTimeRange、startTime、endTime 按请求体中的值更新,未提供时写为空。建议先通过 GetMaintainWindow 获取当前配置后再提交修改。

本接口不修改策略的启用状态,启用或暂停请使用 EnableMaintainWindow、DisableMaintainWindow。时间配置校验与 CreateMaintainWindow 一致;同一工作空间下策略名称重复时返回 InvalidParameterValue;指定的静默策略不存在时返回 ResourceNotFound。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

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. 未找到指定资源。

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。