对单个资源的性能指标设置阈值报警规则。

设置报警规则需要的各云产品的Namespace、MetricName、Dimensions等入参赋值,可通过查询DescribeMetricMetaList接口获得或参考预设监控项参考

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
ContactGroups String 默认报警联系组

报警联系人组,多个联系组之间用英文逗号分隔。

MetricName String cpu_total

监控项名称。可通过查询DescribeMetricMetaList接口获得或参考预设监控项参考

Namespace String acs_ecs_dashboard

产品的数据命名空间,可通过查询DescribeMetricMetaList接口获得或参考预设监控项参考

Resources String [{"instanceId":"xxxxxxx"}]

需要报警的资源。

RuleId String a151cd6023eacee2f0978e03863cc1697c89508****

报警规则ID,调用者统一生成,保证唯一性,已经存在的ID则修改,不存在则创建。

Action String PutResourceMetricRule

系统规定参数。取值:PutResourceMetricRule。

RuleName String 我的报警规则

报警规则的展示名称。

Webhook String http://ww.aliyun.com

报警发生时会回调指定的URL地址。向URL发送POST请求。

EffectiveInterval String 00:00-23:59

报警规则的生效时间范围。

NoEffectiveInterval String 00:00-06:00

报警规则的不生效时间范围。

SilenceTime Integer 86400

通道沉默周期,单位为秒。默认86400秒(即1天),最短为3600秒(即1小时)。监控数据持续超过报警规则阈值时,每个沉默周期内只发送1次报警通知。

Interval String 60

报警规则的探测周期,单位为秒。默认为监控项的最小频率。

EmailSubject String 出现告警了

报警邮件规则主题。

Period String 60

监控数据的聚合周期,单位秒。默认取值为监控项对应的最小频率,通常不需要指定。

Escalations.Critical.Statistics String Average

Critical级别报警统计方法。

Escalations.Critical.ComparisonOperator String GreaterThanOrEqualToThreshold

Critical级别阈值比较符,可以选择如下:

  • GreaterThanOrEqualToThreshold:大于等于
  • GreaterThanThreshold:大于
  • LessThanOrEqualToThreshold:小于等于
  • LessThanThreshold:小于
  • NotEqualToThreshold:不等
  • GreaterThanYesterday:同比昨天时间上涨
  • LessThanYesterday:同比昨天时间下降
  • GreaterThanLastWeek:同比上周同一时间上涨
  • LessThanLastWeek:同比上周同一时间下降
  • GreaterThanLastPeriod:环比上周期上涨
  • LessThanLastPeriod:环比上周期下降
Escalations.Critical.Threshold String 90

Critical级别报警阈值。

Escalations.Critical.Times Integer 3

Critical级别报警重试次数。

Escalations.Warn.Statistics String Average

Warn级别报警统计方法。

Escalations.Warn.ComparisonOperator String GreaterThanOrEqualToThreshold

Warn级别阈值比较符,可以选择如下:

  • GreaterThanOrEqualToThreshold:大于等于
  • GreaterThanThreshold:大于
  • LessThanOrEqualToThreshold:小于等于
  • LessThanThreshold:小于
  • NotEqualToThreshold:不等
  • GreaterThanYesterday:同比昨天时间上涨
  • LessThanYesterday:同比昨天时间下降
  • GreaterThanLastWeek:同比上周同一时间上涨
  • LessThanLastWeek:同比上周同一时间下降
  • GreaterThanLastPeriod:环比上周期上涨
  • LessThanLastPeriod:环比上周期下降
Escalations.Warn.Threshold String 90

Warn级别报警阈值。

Escalations.Warn.Times Integer 3

Warn级别报警重试次数。

Escalations.Info.Statistics String Average

Info级别报警统计方法。

Escalations.Info.ComparisonOperator String GreaterThanOrEqualToThreshold

Info级别阈值比较符,可以选择如下:

  • GreaterThanOrEqualToThreshold:大于等于
  • GreaterThanThreshold:大于
  • LessThanOrEqualToThreshold:小于等于
  • LessThanThreshold:小于
  • NotEqualToThreshold:不等
  • GreaterThanYesterday:同比昨天时间上涨
  • LessThanYesterday:同比昨天时间下降
  • GreaterThanLastWeek:同比上周同一时间上涨
  • LessThanLastWeek:同比上周同一时间下降
  • GreaterThanLastPeriod:环比上周期上涨
  • LessThanLastPeriod:环比上周期下降
Escalations.Info.Threshold String 90

Info级别报警阈值。

Escalations.Info.Times Integer 3

Info级别报警重试次数。

返回数据

名称 类型 示例值 描述
Code String 200

状态码, 200表示成功。

Message String success

错误信息。

RequestId String 65D50468-ECEF-48F1-A6E1-D952E89D9436

请求ID,用于排查问题。

Success Boolean true

是否成功。

示例

请求示例


http(s)://[Endpoint]/?Action=PutResourceMetricRule
&ContactGroups=默认报警联系组
&MetricName=cpu_total
&Namespace=acs_ecs_dashboard
&Resources=[{"instanceId":"xxxxxxx"}]
&RuleId=a151cd6023eacee2f0978e03863cc1697c89508****
&RuleName=我的报警规则
&<公共请求参数>

正常返回示例

XML 格式

<PutResourceMetricRuleResponse>
      <Code>200</Code>
      <Message>success</Message>
      <RequestId>65D50468-ECEF-48F1-A6E1-D952E89D9436</RequestId>
      <Success>true</Success>
</PutResourceMetricRuleResponse>

JSON 格式

{
	"Message":"success",
	"RequestId":"65D50468-ECEF-48F1-A6E1-D952E89D9436",
	"Success":true,
	"Code":"200"
}

错误码

访问错误中心查看更多错误码。