You need to enable JavaScript to run this app.
导航

UpdateNotifyGroupPolicy

最近更新时间2024.04.19 11:53:55

首次发布时间2023.06.30 15:23:34

更新告警聚合策略。

请求说明

  • 请求方式:POST
  • 请求地址:https://open.volcengineapi.com/?Action=UpdateNotifyGroupPolicy&Version=2021-03-03

请求参数

参数名称类型是否必选示例值描述
ActionStringUpdateNotifyGroupPolicy公共参数,本接口值:UpdateNotifyGroupPolicy。
VersionString2021-03-03公共参数,本接口值:2021-03-03。
IdStringce4d942a-bac3-4ef6-b3a0-b7845b3b53bf告警聚合策略 ID。
NameStringtest告警聚合策略名称。
DescriptionString这是一段描述告警聚合策略描述信息。
LevelsArray of NotifyGroupPolicyLevel-告警聚合策略等级。

NotifyGroupPolicyLevel

参数名称类型示例值描述
LevelStringP0告警聚合策略等级,包括:P0、P1 和 P2。
GroupByArray of String["__rule__"]聚合维度,可选值为__rule__。
GroupWaitString30等待时间。正整数形式,单位为 s。
GroupIntervalString30聚合周期。正整数形式,单位为 s。
RepeatIntervalString30通知周期。正整数形式,单位为 s。

说明

若请求参数传入 Levels,Levels 必须传入三种(P0、P1、P2 )情况下聚合策略等级,且 Levels.Level 不能重复。

请求示例

POST /?Action=UpdateNotifyGroupPolicy&Version=2021-03-03
Content-Type:application/json
{
    "Id": "ce4d942a-bac3-4ef6-b3a0-b7845b3b53bf",
    "Name": "test",
    "Description": "这是一段描述"
    "Levels": [
        {
            "Level": "P0",
            "GroupBy": ["__rule__"],
            "GroupWait": "30",
            "GroupInterval": "30",
            "RepeatInterval": "30"
        },
        {
            "Level": "P1",
            "GroupBy": ["__rule__"],
            "GroupWait": "60",
            "GroupInterval": "180",
            "RepeatInterval": "7200"
        },
        {
            "Level": "P2",
            "GroupBy": ["__rule__"],
            "GroupWait": "60",
            "GroupInterval": "300",
            "RepeatInterval": "14400"
        }
    ]
}

返回参数

参数名称类型示例值描述
IdStringce4d942a-bac3-4ef6-b3a0-b7845b3b53bf告警聚合策略 ID。

返回示例

HTTP/1.1 200 OK
Content-Type:application/json
{
    "ResponseMetadata": {
        "RequestId": "202211302208xxxx",
        "Action": "UpdateNotifyGroupPolicy",
        "Version": "2021-03-03",
        "Service": "vmp",
        "Region": "cn-beijing"
    },
    "Result": {
        "Id": "ce4d942a-bac3-4ef6-b3a0-b7845b3b53bf"
    }
}

错误码

本接口错误码如下表所示,公共错误码请参见 公共错误码

HTTP 状态码错误码错误信息描述
404NotFound.IdThe specified NotifyGroupPolicy {{Id}} is not found.未找到指定的告警聚合策略。
409Conflict.NameThe specified name conflicts with existing NotifyGroupPolicy.同一账号下不能有同名的告警聚合策略。