PutResourceMetricRule_阈值报警规则_报警服务_API参考_云监控

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

设置报警规则需要的各个云产品的Namespace、MetricName及Dimensions等请求参数的示例值，请参见DescribeMetricMetaList或云产品主要监控项。

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	PutResourceMetricRule	系统规定参数。取值：PutResourceMetricRule。
ContactGroups	String	是	默认报警联系组	报警联系人组。说明多个联系组之间用英文逗号分隔。
MetricName	String	是	cpu_total	监控项名称。说明详情请参见DescribeMetricMetaList或云产品主要监控项。
Namespace	String	是	acs_ecs_dashboard	产品的数据命名空间。说明详情请参见DescribeMetricMetaList或云产品主要监控项。
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"
}

错误码

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