调用CreateGroupMetricRules接口批量为应用分组创建报警规则。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateGroupMetricRules |
要执行的操作,取值:CreateGroupMetricRules。 |
GroupId | Long | 是 | 123456 |
应用分组ID。 |
GroupMetricRules.N.Category | String | 是 | ecs |
云服务名称。N的取值范围:1~200。取值:
|
GroupMetricRules.N.MetricName | String | 是 | cpu_total |
监控项名称。N的取值范围:1~200。 说明 详细信息请参见DescribeMetricMetaList或云服务监控项。
|
GroupMetricRules.N.Namespace | String | 是 | acs_ecs_dashboard |
云服务的数据命名空间。N的取值范围:1~200。 说明 详细信息请参见DescribeMetricMetaList或云服务监控项。
|
GroupMetricRules.N.RuleId | String | 是 | bfae2ca5b4e07d2c7278772eccda169808c7b**** |
报警规则ID。N的取值范围:1~200。 |
GroupMetricRules.N.RuleName | String | 是 | ECS_Rule1 |
报警规则名称。N的取值范围:1~200。 |
GroupMetricRules.N.Dimensions | String | 否 | [{"instanceId":"i-m5e1qg6uo38rztr4****"}] |
扩展资源维度。N的取值范围:1~200。 说明 当您为应用分组设置报警规则时,会将该应用分组中的所有资源与该报警规则关联。该参数既可以设置实例,也可以设置更深一级的资源,例如,您需要在应用分组下设置所有实例根分区的磁盘使用率,可以设置为
[ {"dskName":"/"} ] 。
|
GroupMetricRules.N.EffectiveInterval | String | 否 | 00:00-23:59 |
报警规则的生效时间范围。N的取值范围:1~200。 |
GroupMetricRules.N.NoEffectiveInterval | String | 否 | 00:00-05:30 |
报警规则的非生效时间范围。N的取值范围:1~200。 |
GroupMetricRules.N.SilenceTime | Integer | 否 | 86400 |
报警通知的沉默周期。单位:秒,最小值:3600,默认值:86400。 N的取值范围:1~200。 |
GroupMetricRules.N.Period | String | 否 | 60 |
监控数据的聚合周期。单位:秒,取值:60或60的整数倍。默认值:300。 N的取值范围:1~200。 说明 该参数设置为300秒,表示将原始上报的5分钟内的监控数据的平均值作为报警参考点。
|
GroupMetricRules.N.Interval | String | 否 | 60 |
报警规则的探测周期。单位:秒,默认为监控项的最小频率。 N的取值范围:1~200。 说明 建议报警的探测周期和数据上报周期保持一致。如果报警规则的探测周期小于数据上报周期,会因为数据不足而不能触发报警。
|
GroupMetricRules.N.Webhook | String | 否 | https://www.aliyun.com |
报警发生回调时指定的URL地址。N的取值范围:1~200。 |
GroupMetricRules.N.EmailSubject | String | 否 | ECS_Instance1 |
邮件主题。N的取值范围:1~200。 |
GroupMetricRules.N.Escalations.Critical.Statistics | String | 否 | Average |
Critical级别报警统计方法。N的取值范围:1~200。 说明 详细信息请参见DescribeSystemEventMetaList。
|
GroupMetricRules.N.Escalations.Critical.ComparisonOperator | String | 否 | GreaterThanOrEqualToThreshold |
Critical级别阈值比较符。N的取值范围:1~200。取值:
|
GroupMetricRules.N.Escalations.Critical.Threshold | String | 否 | 90 |
Critical级别报警阈值。N的取值范围:1~200。 |
GroupMetricRules.N.Escalations.Critical.Times | Integer | 否 | 3 |
Critical级别报警重试次数。N的取值范围:1~200。 |
GroupMetricRules.N.Escalations.Warn.Statistics | String | 否 | Average |
Warn级别报警统计方法。N的取值范围:1~200。 说明 详细信息请参见DescribeSystemEventMetaList。
|
GroupMetricRules.N.Escalations.Warn.ComparisonOperator | String | 否 | GreaterThanOrEqualToThreshold |
Warn级别阈值比较符。N的取值范围:1~200。取值:
|
GroupMetricRules.N.Escalations.Warn.Threshold | String | 否 | 90 |
Warn级别报警阈值。N的取值范围:1~200。 |
GroupMetricRules.N.Escalations.Warn.Times | Integer | 否 | 3 |
Warn级别报警重试次数。N的取值范围:1~200。 |
GroupMetricRules.N.Escalations.Info.Statistics | String | 否 | Average |
Info级别报警统计方法。N的取值范围:1~200。 说明 详细信息请参见DescribeSystemEventMetaList。
|
GroupMetricRules.N.Escalations.Info.ComparisonOperator | String | 否 | GreaterThanOrEqualToThreshold |
Info级别阈值比较符。N的取值范围:1~200。取值:
|
GroupMetricRules.N.Escalations.Info.Threshold | String | 否 | 90 |
Info级别报警阈值。N的取值范围:1~200。 |
GroupMetricRules.N.Escalations.Info.Times | Integer | 否 | 3 |
Info级别报警重试次数。N的取值范围:1~200。 |
报警级别Critical、Warn和Info至少设置一种,否则创建报警规则失败。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | Integer | 200 |
状态码。 说明 200表示成功。
|
Message | String | The Request is not authorization. |
错误信息。 |
RequestId | String | 461CF2CD-2FC3-4B26-8645-7BD27E7D0F1D |
请求ID。 |
Resources | Array of AlertResult |
创建资源列表。 |
|
AlertResult | |||
Code | Integer | 200 |
状态码。 说明 200表示成功。
|
Message | String | Metric not found. |
错误信息。 |
RuleId | String | a151cd6023eacee2f0978e03863cc1697c89508**** |
报警规则ID。 |
RuleName | String | ECS_Rule1 |
报警规则名称。 |
Success | Boolean | true |
操作是否成功。取值:
|
Success | Boolean | true |
操作是否成功。取值:
|
示例
请求示例
http(s)://[Endpoint]/?Action=CreateGroupMetricRules
&GroupId=123456
&GroupMetricRules.1.Category=ecs
&GroupMetricRules.1.MetricName=cpu_total
&GroupMetricRules.1.1amespace=acs_ecs_dashboard
&GroupMetricRules.1.RuleId=bfae2ca5b4e07d2c7278772eccda169808c7b****
&GroupMetricRules.1.RuleName=ECS_Rule1
&GroupMetricRules.1.Escalations.Critical.Statistics=Average
&GroupMetricRules.1.Escalations.Critical.ComparisonOperator=GreaterThanOrEqualToThreshold
&GroupMetricRules.1.Escalations.Critical.Threshold=90
&GroupMetricRules.1.Escalations.Critical.Times=3
&<公共请求参数>
正常返回示例
XML
格式
<CreateGroupMetricRulesResponse>
<RequestId>65D50468-ECEF-48F1-A6E1-D952E89D9436</RequestId>
<Success>true</Success>
<Code>200</Code>
<Resources>
<AlertResult>
<RuleId>a151cd6023eacee2f0978e03863cc1697c89508****</RuleId>
<Success>true</Success>
<RuleName>ECS_Rule1</RuleName>
<Code>200</Code>
</AlertResult>
<AlertResult>
<Message>Metric not found.</Message>
<RuleId>hyu91929****</RuleId>
<Success>false</Success>
<RuleName>ECS_Rule2</RuleName>
<Code>404</Code>
</AlertResult>
</Resources>
</CreateGroupMetricRulesResponse>
JSON
格式
{
"RequestId": "65D50468-ECEF-48F1-A6E1-D952E89D9436",
"Success": "true",
"Code": "200",
"Resources": {
"AlertResult": [
{
"RuleId": "a151cd6023eacee2f0978e03863cc1697c89508****",
"Success": "true",
"RuleName": "ECS_Rule1",
"Code": "200"
},
{
"Message": "Metric not found.",
"RuleId": "hyu91929****",
"Success": "false",
"RuleName": "ECS_Rule2",
"Code": "404"
}
]
}
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交