绑定告警规则和对象

最近更新时间:2019-05-13 18:51:39

1. 接口描述

域名:monitor.api.qcloud.com
接口名:BindAlarmRuleObjects

绑定之后,会用该条告警规则去分析对应对象上报的数据,当满足告警规则的告警触发条件时,会触发告警。
对象是指被统计的实体,例如统计磁盘利用率时,则磁盘为对象,由维度名称和值的信息dimensions.0.name=ip,dimensions.1.name=diskname,
dimensions.0.value=172.31.58.160,dimensions.1.value=sda确定。
1条告警规则可以绑定多个不同的对象,1个对象也可以绑定多个不同的告警规则。

2. 输入参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见公共请求参数页面。其中,此接口的Action字段为BindAlarmRuleObjects。

参数名称 必选 类型 描述
alarmRuleId String 告警规则ID,调用查询告警规则(DescribeAlarmRuleList)接口查询
dimensions.n.name String 维度组合的名称的组合,调用查询告警规则(DescribeAlarmRuleList)接口查询,填写返回值中dimensionGroup对应的字段
dimensions.n.value string 维度组合的value的组合,此处的value的组合用户自定义,为dimensions.n.name对应的值

3. 输出参数

参数名称 类型 描述
code Int 错误码, 0: 成功, 其他值表示失败,详见错误码页面的公共错误码页面
message String 错误信息

4. 示例

输入

https://monitor.api.qcloud.com/v2/index.php?
&<公共请求参数>
&alarmRuleId = policy-ou3kyu2f 
&dimensions.0.name=ip
&dimensions.1.name=diskname
&dimensions.0.value=172.31.58.160
&dimensions.1.value=sda

输出

{
    "code":"0",
    "message":""
}