最近更新时间:2024.03.12 16:52:17
首次发布时间:2022.10.26 11:08:02
调用CreateEventRule接口创建事件规则。
该接口调用服务方较多,不建议高频调用,否则将触发限流。建议QPS值不大于20。
POST https://open.volcengineapi.com?Action=CreateEventRule&Version=2018-01-01
ServiceName : Volc_Observe Region : cn-beijing AccessKey : xxx SecretKey : xxx
参数 | 类型 | 是否必填 | 示例值 | 说明 |
---|---|---|---|---|
RuleName | String | 是 |
| 规则名称。 |
Description | String | 否 |
| 规则描述。 |
EventBusName | String | 是 |
| 事件总线名称。目前仅支持填写default。 |
EventSource | String | 是 |
| 事件源。 |
EventType | Array | 否 |
| 事件类型。 |
Status | String | 否 |
| 规则状态。
|
Level | String | 是 |
| 告警规则的严重程度。
|
FilterPattern | Object | 是 | - | 过滤模式,也叫事件匹配规则。具体格式,请参见FilterPattern请求参数。 |
EffectiveTime | Object | 是 | - | 规则生效时间,规则只会在这段时间内生效。具体格式,请参见EffectiveTime请求参数。 |
ContactMethods | Array | 否 |
| 告警通知方式。
|
ContactGroupIds | Array | 否 |
| 告警通知方式为电话、短信、邮件时,触发的告警联系组ID。 |
Endpoint | String | 否 |
| 告警通知方式为告警回调时,触发的回调地址。 |
TLSTarget | Array | 否 |
| 告警方式为日志服务时,触发的日志服务的配置。 |
MessageQueue | Array | 否 |
| 告警通知方式为消息队列kafka时,触发的消息队列。 注意
|
参数 | 类型 | 是否必填 | 示例值 | 说明 |
---|---|---|---|---|
Type | Array | 是 |
| 模式匹配中对应的事件类型列表,当前为任意匹配。 |
Source | String | 是 |
| 模式匹配中对应的事件源。 |
参数 | 类型 | 是否必填 | 示例值 | 说明 |
---|---|---|---|---|
StartTime | String | 是 |
| 规则启用的开始时间。 |
EndTime | String | 是 |
| 规则启用的结束时间。 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
RuleId | String |
| 规则ID。 |
POST https://open.volcengineapi.com?Action=CreateEventRule&Version=2018-01-01 ServiceName=Volc_Observe Region=cn-beijing AccessKey=xxx SecretKey=xxx { "RuleName":"rule-01", "Description":"This is test rule 01", "EventBusName":"default", "EventSource":"ecs", "EventType":[ "ecs:Disk:DiskError.Redeploy.Executing", "ecs:Disk:DiskError.Redeploy.Inquiring", "ecs:Disk:DiskError.Redeploy.Succeeded" ], "Status":"enable", "Level":"warning", "FilterPattern":{ "Type":[ "ecs:Disk:DiskError.Redeploy.Executing", "ecs:Disk:DiskError.Redeploy.Inquiring", "ecs:Disk:DiskError.Redeploy.Succeeded" ], "Source":"ecs" }, "EffectiveTime":{ "StartTime":"09:00", "EndTime":"20:59" }, "ContactMethods":[ "Webhook", "Email", "SMS" ], "Endpoint":"http://example.com/alert" }
{ "ResponseMetadata":{ "RequestId":"20230****4C52", "Action":"CreateEventRule", "Version":"2018-01-01", "Service":"Volc_Observe", "Region":"cn-beijing" }, "Result":{ "Data":{ "RuleID":"157284163494346****" } } }