调用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级别阈值比较符。您可以根据以下规则进行选择:
|
Escalations.Critical.Threshold | String | 否 | 90 |
Critical级别报警阈值。 |
Escalations.Critical.Times | Integer | 否 | 3 |
Critical级别报警重试次数。 |
Escalations.Warn.Statistics | String | 否 | Average |
Warn级别报警统计方法。 |
Escalations.Warn.ComparisonOperator | String | 否 | GreaterThanOrEqualToThreshold |
Warn级别阈值比较符。您可以根据以下规则进行选择:
|
Escalations.Warn.Threshold | String | 否 | 90 |
Warn级别报警阈值。 |
Escalations.Warn.Times | Integer | 否 | 3 |
Warn级别报警重试次数。 |
Escalations.Info.Statistics | String | 否 | Average |
Info级别报警统计方法。 |
Escalations.Info.ComparisonOperator | String | 否 | GreaterThanOrEqualToThreshold |
Info级别阈值比较符。您可以根据以下规则进行选择:
|
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"
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交