调用DescribeMetricRuleList接口查询报警规则列表。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeMetricRuleList |
系统规定参数。取值：DescribeMetricRuleList。 |
| Namespace | String | 否 | acs_ecs_dashboard |
产品的数据命名空间。 说明 详情请参见DescribeSystemEventMetaList或参考云产品主要监控项。
|
| MetricName | String | 否 | cpu_total |
监控项名称。 说明 详情请参见DescribeSystemEventMetaList或参考云产品主要监控项。
|
| EnableState | Boolean | 否 | true |
启用状态。取值：
默认为空，即所有状态（包含启用和禁用）的规则。 |
| Page | String | 否 | 1 |
分页码，默认为1。 |
| PageSize | String | 否 | 10 |
每页显示记录条数，默认为10。 |
| AlertState | String | 否 | ALARM |
报警规则状态。取值：
|
| Dimensions | String | 否 | {"instanceId":"i-xy123****"} |
维度map，用于查询指定资源的监控数据。 格式为
说明
Dimensions传入时需要使用JSON字符串表示该Map对象，必须按顺序传入。
|
| RuleName | String | 否 | ECSCPU报警规则 |
报警规则名称。 说明 该参数支持模糊查询。
|
| GroupId | String | 否 | 123456 |
应用分组ID。 |
| RuleIds | String | 否 | a151cd6023eacee2f0978e03863cc1697c8950812**** |
报警规则ID。 说明 该参数支持一次查询多个，多个ID之间用逗号分隔，一次最多可查询20条。
|
查询报警规则列表。
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 0E657631-CD6C-4C24-9637-98D000B9272C |
请求ID。 |
| Code | Integer | 200 |
状态码。 说明 状态码为200表示成功。
|
| Total | String | 21 |
总记录条数。 |
| Success | Boolean | true |
请求是否成功。 |
| Alarms | Array |
报警规则列表。 |
|
| Alarm |
报警规则列表。 |
||
| AlertState | String | OK |
报警规则状态。取值：
|
| ContactGroups | String | 默认报警联系人 |
报警联系人。 |
| Dimensions | String | [{}] |
维度map，用于查询指定资源的监控数据。 格式为
说明
Dimensions传入时需要使用JSON字符串表示该Map对象，必须按顺序传入。
|
| EffectiveInterval | String | 00:00-23:59 |
报警规则的生效时间段。 |
| EnableState | Boolean | true |
启用状态。取值：
默认为空，即所有状态（包含启用和禁用）的规则。 |
| Escalations |
报警分级别触发条件。 |
||
| Critical |
Critical级别报警触发条件。 |
||
| ComparisonOperator | String | GreaterThanOrEqualToThreshold |
Critical级别阈值比较符，可以选择如下：
|
| Statistics | String | Average |
Critical级别报警统计方法。 |
| Threshold | String | 90 |
Critical级别阈值。 |
| Times | String | 3 |
Critical级别连续出现次数，连续出现这个次数并且超过阈值才会触发报警。 |
| Info |
Info级别报警触发条件。 |
||
| ComparisonOperator | String | GreaterThanOrEqualToThreshold |
Info级别阈值比较符，可以选择如下：
|
| Statistics | String | Average |
Info级别报警统计方法。 |
| Threshold | String | 90 |
Info级别阈值。 |
| Times | String | 1 |
Info级别连续出现次数，连续出现这个次数并且超过阈值才会触发报警。 |
| Warn |
Warn级别报警触发条件。 |
||
| ComparisonOperator | String | GreaterThanOrEqualToThreshold |
Warn级别阈值比较符，可以选择如下：
|
| Statistics | String | Average |
Warn级别报警统计方法 |
| Threshold | String | 90 |
Warn级别阈值 |
| Times | String | 3 |
Warn级别连续出现次数，连续出现这个次数并且超过阈值才会触发报警 |
| GroupId | String | 123456 |
应用分组ID。 |
| GroupName | String | 我的应用组 |
应用分组名称。 说明 如果报警规则是关联到应用分组上的，则此处显示该参数。
|
| MailSubject | String | 发生报警 |
报警邮件主题定义。 |
| MetricName | String | cpu_total |
监控项名称。 |
| Namespace | String | acs_ecs_dashboard |
产品的数据命名空间，用于区分不同的产品。 |
| NoEffectiveInterval | String | 00:00-23:59 |
报警规则不生效时间段。 |
| Period | String | 60 |
统计周期。 |
| Resources | String | [{\"instanceId\":\"i-a2d5q7pm3f9yr29e****\"},{\"instanceId\":\"i-a2d5q7pm3f9yr29e****\"} |
报警规则关联的资源。 |
| RuleId | String | a151cd6023eacee2f0978e03863cc1697c895012**** |
报警规则ID。 |
| RuleName | String | 我的报警规则 |
报警规则名称。 |
| SilenceTime | String | 86400 |
通道沉默周期，单位为秒。默认86400秒（即1天），最短为3600秒（即1小时）。监控数据持续超过报警规则阈值时，每个沉默周期内只发送1次报警通知。 |
| SourceType | String | METRIC |
报警规则类型 METRIC：时序指标报警规则 EVENT：旧版本事件类型报警规则（已废弃） |
| Webhook | String | http://www.aliyun.com |
URL回调地址。 |
| Message | String | success |
错误信息。 |
示例
请求示例
http(s)://[Endpoint]/?Action=DescribeMetricRuleList
&<公共请求参数>
正常返回示例
XML 格式
<Alarms>
<Alarm>
<Period>60</Period>
<Statistics>Average</Statistics>
<GroupName>组的名称</GroupName>
<Webhook/>
<Subject>aaabbb</Subject>
<EffectiveInterval>00:00-23:59</EffectiveInterval>
<RuleName>我的报警规则</RuleName>
<NoEffectiveInterval/>
<GroupId>3596360</GroupId>
<EvaluationCount>3</EvaluationCount>
<MetricName>cpu_total</MetricName>
<Threshold>92</Threshold>
<State>OK</State>
<Enable>true</Enable>
<SilenceTime>86400</SilenceTime>
<Dimensions>[{}]</Dimensions>
<RuleId>a151cd6023eacee2f0978e03863cc1697c89508e2b61****</RuleId>
<Namespace>acs_ecs_dashboard</Namespace>
<ContactGroups>测试</ContactGroups>
<Escalations>
<Critical>
<Statistics>Average</Statistics>
<Threshold>92</Threshold>
<Times>3</Times>
<ComparisonOperator>GreaterThanOrEqualToThreshold</ComparisonOperator>
</Critical>
<Info/>
<Warn/>
</Escalations>
<ComparisonOperator>>=</ComparisonOperator>
<Resources>[{"instanceId":"i-a2d5q7pm3f12****"}]</Resources>
</Alarm>
<Alarm>
<Period>60</Period>
<Statistics>Average</Statistics>
<GroupName>demo</GroupName>
<Webhook/>
<Subject>${serviceType}-${metricName}-${levelDescription}通知（${dimensions}）</Subject>
<EffectiveInterval>00:00-23:59</EffectiveInterval>
<RuleName>xxxxxxxxxxxxxxx</RuleName>
<NoEffectiveInterval/>
<GroupId>12345</GroupId>
<EvaluationCount>3</EvaluationCount>
<MetricName>cpu_total</MetricName>
<Threshold>90</Threshold>
<State>OK</State>
<Enable>true</Enable>
<SilenceTime>86400</SilenceTime>
<Dimensions>[{}]</Dimensions>
<RuleId>alarmRule_uuid_adbe286748952b82c6a4ebe3a07521697bb706****</RuleId>
<Namespace>acs_ecs_dashboard</Namespace>
<ContactGroups>rongfei</ContactGroups>
<Escalations>
<Critical>
<Statistics>Average</Statistics>
<Threshold>6666</Threshold>
<Times>3</Times>
<ComparisonOperator>GreaterThanOrEqualToThreshold</ComparisonOperator>
</Critical>
<Info/>
<Warn/>
</Escalations>
<ComparisonOperator>>=</ComparisonOperator>
<Resources>[{"instanceId":"host-fTcUci7****"}</Resources>
</Alarm>
</Alarms>
<RequestId>0F05309F-8863-4B2A-8F52-C6AA00E701B4</RequestId>
<Success>true</Success>
<Code>200</Code>
<Total>102</Total>JSON 格式
{
"RequestId":"0F05309F-8863-4B2A-8F52-C6AA00E701B4",
"Alarms":{
"Alarm":[
{
"Period":60,
"Statistics":"Average",
"GroupName":"组的名称",
"Webhook":"",
"Subject":"aaabbb",
"EffectiveInterval":"00:00-23:59",
"RuleName":"我的报警规则",
"NoEffectiveInterval":"",
"GroupId":"3596360",
"EvaluationCount":3,
"MetricName":"cpu_total",
"State":"OK",
"Threshold":"92",
"Enable":true,
"SilenceTime":86400,
"Dimensions":"[{}]",
"RuleId":"a151cd6023eacee2f0978e03863cc1697c89508e2b61****",
"Namespace":"acs_ecs_dashboard",
"ContactGroups":"测试",
"ComparisonOperator":">=",
"Escalations":{
"Critical":{
"Statistics":"Average",
"Threshold":"92",
"Times":3,
"ComparisonOperator":"GreaterThanOrEqualToThreshold"
},
"Info":{},
"Warn":{}
},
"Resources":"[{\"instanceId\":\"i-a2d5q7pm3f12****\"}]"
},
{
"Period":60,
"Statistics":"Average",
"GroupName":"demo",
"Webhook":"",
"Subject":"${serviceType}-${metricName}-${levelDescription}通知（${dimensions}）",
"EffectiveInterval":"00:00-23:59",
"RuleName":"xxxxxxxxxxxxxxx",
"NoEffectiveInterval":"",
"GroupId":"12345",
"EvaluationCount":3,
"MetricName":"cpu_total",
"State":"OK",
"Threshold":"90",
"Enable":true,
"SilenceTime":86400,
"Dimensions":"[{}]",
"RuleId":"alarmRule_uuid_adbe286748952b82c6a4ebe3a07521697bb706****",
"Namespace":"acs_ecs_dashboard",
"ContactGroups":"rongfei",
"ComparisonOperator":">=",
"Escalations":{
"Critical":{
"Statistics":"Average",
"Threshold":"6666",
"Times":3,
"ComparisonOperator":"GreaterThanOrEqualToThreshold"
},
"Info":{},
"Warn":{}
},
"Resources":"[{\"instanceId\":\"host-fTcUci7****\"}"
}
]
},
"Success":true,
"Code":"200",
"Total":102
}错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交