GetMaintainWindow - 获取静默策略-云监控(CMS)-阿里云帮助中心

接口说明

查询指定静默策略的详细配置，包括策略名称、描述、启用状态、过滤条件、生效时间配置以及创建时间和更新时间。当前查询结果不返回 workspaceFilterSetting。指定的静默策略不存在时返回 ResourceNotFound。

调试

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

调试

授权信息

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

请求语法

GET /maintainWindows/{maintainWindowId} HTTP/1.1

路径参数

名称	类型	必填	描述	示例值
maintainWindowId	string	是	静默策略 ID。创建静默策略时若未指定则由系统生成，可通过 ListMaintainWindows 查询。	3ff3fbd0-8a0b-4b31-9b1c-8e3f0a2c5d71

请求参数

名称	类型	必填	描述	示例值
workspace	string	否	工作空间名称。后端要求必填，用于隔离不同业务空间的静默策略资源。	default-cms-xxxx-cn-hangzhou

返回参数

名称	类型	描述	示例值
	object	响应内容结构。
maintainWindow	MaintainWindowForView	静默策略详情，包含策略 ID、名称、描述、启用状态、filterSetting、生效时间配置以及创建时间和更新时间；不返回 workspaceFilterSetting。
requestId	string	本次请求的唯一 ID，用于问题排查与工单定位。	0CEC5375-C554-562B-A65F-9A629907C1F0

示例

正常返回示例

JSON格式

{
  "maintainWindow": {
    "workspace": "workspace-test",
    "maintainWindowId": "123-12-312-31-23123",
    "description": "test",
    "filterSetting": {
      "expression": "1 and 2 or 3",
      "conditions": [
        {
          "op": "EQ",
          "field": "labels.alertname\t",
          "value": "CRITICAL"
        }
      ],
      "relation": "AND"
    },
    "maintainWindowName": "测试策略",
    "updateTime": "2025-05-07T02:19:05Z",
    "effectTimeRange": {
      "startTimeInMinute": 60,
      "timeZone": "+08:00",
      "dayInWeek": [
        3
      ],
      "endTimeInMinute": 360
    },
    "userId": "12312312***",
    "effective": "* * 14-18 ? * *",
    "createTime": "2025-03-11T08:21:58Z",
    "enable": true,
    "startTime": "2024-11-26 10:02:01",
    "endTime": "2024-11-26 12:02:01"
  },
  "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.	未找到指定资源。

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

变更历史

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