调用PutResourceMetricRule接口对单个资源的性能指标设置阈值报警规则。

设置报警规则需要的各个云产品的NamespaceMetricNameDimensions等请求参数的示例值,请参见DescribeMetricMetaList云产品主要监控项

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String PutResourceMetricRule

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

ContactGroups String 默认报警联系组

报警联系人组。

说明 多个联系组之间用英文逗号分隔。
MetricName String cpu_total

监控项名称。

Namespace String acs_ecs_dashboard

产品的数据命名空间。

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

需要报警的资源。

说明 详情请参见云产品主要监控项中对应监控项的Dimensions信息。
RuleId String a151cd6023eacee2f0978e03863cc1697c89508****

报警规则ID。

说明 由调用者统一生成。如果报警规则ID已经存在,则表示修改报警规则,如果报警规则ID不存在,则表示创建该报警规则。
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天)。

说明 当监控数据持续超过报警规则阈值时,每个沉默周期内只发送1次报警通知。
Interval String 60

报警规则的探测周期,即报警系统多长时间检查一次是否要触发报警规则。单位为秒,默认为监控项的最小频率。

说明 关于监控数据频率请参见DescribeMetricMetaList
EmailSubject String 出现告警了

报警邮件规则主题。

Period String 60

监控数据的聚合周期,单位为秒,取值为60或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 格式

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

JSON 格式

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

错误码

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