文档首页> 云监控服务 CES> API参考> API V2> 告警通知> 修改告警规则告警通知信息
更新时间:2024-04-26 GMT+08:00
分享

修改告警规则告警通知信息

功能介绍

修改告警规则告警通知信息,告警策略&资源请使用对应接口

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

PUT /v2/{project_id}/alarms/{alarm_id}/notifications

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户ID

最小长度:1

最大长度:64

alarm_id

String

告警规则ID

正则匹配:^al([0-9A-Za-z]){22}$

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

发送的实体的MIME类型。默认使用application/json; charset=UTF-8。

缺省值:application/json; charset=UTF-8

最小长度:1

最大长度:64

X-Auth-Token

String

用户Token

最小长度:1

最大长度:16384

表3 请求Body参数

参数

是否必选

参数类型

描述

notification_enabled

Boolean

是否开启告警通知,值为true时,其他字段均必选,值为false时,其他字段可不选

alarm_notifications

Array of Notification objects

告警触发的动作

ok_notifications

Array of Notification objects

告警恢复触发的动作

notification_begin_time

String

告警通知开启时间

notification_end_time

String

告警通知关闭时间

表4 Notification

参数

是否必选

参数类型

描述

type

String

通知类型, notification代表通过SMN通知

正则匹配:^(notification|autoscaling|ecsRecovery|contact|contactGroup|iecAction)$

notification_list

Array of strings

告警状态发生变化时,被通知对象的列表。topicUrn可从SMN获取,具体操作请参考查询Topic列表。当type为notification时,notification_list列表不能为空。 说明:若alarm_action_enabled为true,对应的alarm_actions、ok_actions至少有一个不能为空。若alarm_actions、ok_actions同时存在时,notification_list值保持一致。

数组长度:0 - 20

响应参数

状态码: 200

表5 响应Body参数

参数

参数类型

描述

notification_enabled

Boolean

是否开启告警通知

alarm_notifications

Array of Notification objects

告警触发的动作

ok_notifications

Array of Notification objects

告警恢复触发的动作

notification_begin_time

String

告警通知开启时间

notification_end_time

String

告警通知关闭时间

表6 Notification

参数

参数类型

描述

type

String

通知类型, notification代表通过SMN通知

正则匹配:^(notification|autoscaling|ecsRecovery|contact|contactGroup|iecAction)$

notification_list

Array of strings

告警状态发生变化时,被通知对象的列表。topicUrn可从SMN获取,具体操作请参考查询Topic列表。当type为notification时,notification_list列表不能为空。 说明:若alarm_action_enabled为true,对应的alarm_actions、ok_actions至少有一个不能为空。若alarm_actions、ok_actions同时存在时,notification_list值保持一致。

数组长度:0 - 20

状态码: 400

表7 响应Body参数

参数

参数类型

描述

error_code

String

请求异常内部业务状态码

最小长度:0

最大长度:256

error_msg

String

请求异常信息

最小长度:0

最大长度:256

request_id

String

请求ID

最小长度:0

最大长度:256

状态码: 500

表8 响应Body参数

参数

参数类型

描述

error_code

String

请求异常内部业务状态码

最小长度:0

最大长度:256

error_msg

String

请求异常信息

最小长度:0

最大长度:256

request_id

String

请求ID

最小长度:0

最大长度:256

请求示例

修改告警规则告警通知信息

{
  "notification_enabled" : true,
  "alarm_notifications" : [ {
    "type" : "",
    "notification_list" : [ ]
  } ],
  "ok_notifications" : [ {
    "type" : "",
    "notification_list" : [ ]
  } ],
  "notification_begin_time" : "00:00",
  "notification_end_time" : "23:59"
}

响应示例

状态码: 200

修改告警规则告警通知信息成功

{
  "notification_enabled" : true,
  "alarm_notifications" : [ {
    "type" : "",
    "notification_list" : [ ]
  } ],
  "ok_notifications" : [ {
    "type" : "",
    "notification_list" : [ ]
  } ],
  "notification_begin_time" : "00:00",
  "notification_end_time" : "23:59"
}

状态码

状态码

描述

200

修改告警规则告警通知信息成功

400

参数校验失败

500

系统内部错误

错误码

请参见错误码

分享:

    相关文档

    相关产品