帮助与文档

我们为你提供丰富、详尽的使用指南以及产品文档

CreateAlarmPolicy

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

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

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

Request Parameters

Parameter name Type Description Required
alarm_policy_type String 告警策略类型 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

公共参数

Response Elements

Name Type Description
action String 响应动作
alarm_policy_id String 创建成功的告警策略 ID
ret_code Integer 执行成功与否,0 表示成功,其他值则为错误代码

Example

Example Request:

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

Example Response:

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