创建告警策略,每个告警策略可以绑定多个资源。

创建策略时,可一同创建规则(rules) 和行为(action) ,也可创建之后再添加规则或行为。

告警策略数据可以通过 DescribeAlarmPolicies 得到。

请求参数

Parameter name Type Description Required

alarm_policy_type

String

告警策略类型: 云服务器(instance),路由器(router),公网 IP(eip),负载均衡器(loadbalancer_listener_http / loadbalancer_listener_https / loadbalancer_listener_tcp / loadbalancer_backend_http / loadbalancer_backend_tcp),集群(cluster_node)

Yes

period

String

告警策略周期:一分钟:1m ,5分钟:5m

Yes

alarm_policy_name

String

告警策略名称

No

zone

String

区域 ID,注意要小写

Yes

notice_count

Integer

连续告警次数(1-5)

No

rules.n.alarm_policy_rule_name

String

规则名称

No

rules.n.meter

String

资源监控项,不同资源类型有不同的监控项。可参考资源监控

No

rules.n.condition_type

String

条件类型: gt (大于), lt (小于)

No

rules.n.thresholds

Integer

阈值

No

rules.n.data_processor

String

监控数据处理方式: raw (使用监控数据原始值), percent (只适用于 IP 带宽监控,将监控数据转换为带宽占用百分比,再跟阈值进行比较) 默认是 raw 。

No

rules.n.consecutive_periods

Integer

连续周期数,即连续几个检查周期,监控数据都达到了告警阈值,才触发告警行为。 默认是 1 。

No

rules.n.period_start_hhmm

String

规则生效开始时间

No

rules.n.period_end_hhmm

String

规则生效结束时间

No

rules.n.alarm_level_id

String

告警级别,level-00000000 表示高,level-00000001表示低

No

actions.n.trigger_action

String

通知列表 ID ,

No

actions.n.trigger_status

String

当监控告警变成什么状态时,发消息给此通知列表。有效值是 ok, alarm, insufficient

No

除上述请求参数外,还包含公共参数

返回数据

Name Type Description

action

String

响应动作

alarm_policy_id

String

创建成功的告警策略 ID

ret_code

Integer

执行成功与否,0 表示成功,其他值则为错误代码

请求示例

https://api.qingcloud.com/iaas/?action=CreateAlarmPolicy
&alarm_policy_type=eip
&period=5m
&zone=pek3a
&COMMON_PARAMS

返回示例

{
  "action":"CreateAlarmPolicyResponse",
  "alarm_policy_id":"alp-axbkmf20",
  "ret_code":0
}