告警相关接口

更新时间：2026-04-15

查询告警模板列表

请求方法 GET

请求路径：/v2/alerting_rule_template

请求结构

Plain Text

1GET /v2/alerting_rule_template HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

无

返回头域

除公共头域外，无其它特殊头域。

返回参数

参数名称	类型	描述
ruleTemplates	List< RuleTemplate>	告警模板列表

RuleTemplate：

字段	类型	说明
alertName	String	告警名称
expr	String	告警规则，promQL查询语句
for	String	告警持续时间
description	String	告警内容

请求示例

Plain Text

1GET /v2/alerting_rule_template HTTP/1.1
2Host: cprom.bj.baidubce.com
3Content-Type: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8
5{
6    "ruleTemplates": [
7        {
8            "alertName": "CCE-节点不可用报警",
9            "expr": "sum(kube_node_status_condition{condition=\"Ready\",status=\"false\",region=\"\", clusterID=~\"\"}) \u003e 0",
10            "for": "2m",
11            "description": "cluster: {{ $labels.clusterID }}, region: {{ $labels.region }} SUM of node not Ready \u003e 0, current: {{ $value | printf \"%.2f\" }}"
12        },
13        {
14            "alertName": "CCE-节点不可调度报警",
15            "expr": "sum(kube_node_spec_unschedulable{region=\"\", clusterID=~\"\"}) \u003e 0",
16            "for": "2m",
17            "description": "cluster: {{ $labels.clusterID }}, region: {{ $labels.region }} SUM of node unschedulable \u003e 0, current: {{ $value | printf \"%.2f\" }}"
18        }
19      ]
20
21}

查询通知策略列表

请求方法 GET

请求路径：/v2/notify_rule

请求结构

Plain Text

1GET /v2/notify_rule?pageNo=1&pageSize=10  HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
pageSize	Integer	否	QueryString	分页查询监控实例列表每页监控实例个数，范围为1-100，缺省值为10
pageNo	Integer	否	QueryString	分页查询监控实例列表分页页码数，缺省值为1
keywordType	String	否	QueryString	筛选条件类型，默认为notifyRuleName，只支持notifyRuleName
keyword	String	否	QueryString	筛选条件关键字

返回头域

除公共头域外，无其它特殊头域。

返回参数

参数名称	类型	描述
keywordType	String	筛选条件类型
keyword	String	筛选条件关键字
orderBy	String	通知策略列表排序依据字段
order	String	通知策略列表排序方式：desc倒序，asc升序
pageNo	Integer	通知策略分页当前页码数
pageSize	Integer	当前页页通知策略个数
totalCount	Integer	通知策略总个数
items	List< NotifyRule >	通知策略列表

NotifyRule

字段	类型	说明
notifyRuleId	String	通知策略ID
notifyRuleName	String	通知名称
startTime	String	通知时段开始时间
endTime	String	通知时段终止时间
channel	List< String >	通知渠道，phone:电话 , sms: 短信, email: 邮件
receiverType	String	接收者类型，user：用户，userGroup：用户组
users	List< User >	用户列表
userGroups	List< UserGroup >	用户组列表
webhookConfigList	List< CallbackConfig >	webhook 回调配置信息列表
escalateConfigList	List< EscalateParam >	通知策略升级参数列表
repeatNotifyConfig	RepeatNotifyConfig	重复通知配置
createTime	String	创建时间
updateTime	String	更新时间

User

字段	类型	说明
userId	String	用户ID
userName	String	用户名称
userType	String	用户类型, 默认identity
phoneNumber	String	用户手机号码
email	String	用户邮箱

UserGroup

字段	类型	说明
groupId	String	用户组ID
groupName	String	用户组名称
description	String	用户组描述

CallbackConfig

字段	类型	说明
webhookType	String	回调类型，weCom:企业微信，dingTalk:钉钉，lark:飞书，custom:自定义webhook
webhookList	List< WebhookDetail >	webhook配置详情列表

WebhookDetail

字段	类型	说明
hookName	String	机器人名称
hookMethod	String	webhook请求的HTTP方法，默认post
hookUrl	String	机器人地址
headers	Map<String,String>	webhook请求的HTTP头部信息
params	Map<String,String>	webhook请求参数
mentionedUsers	MentionedUserConfig	群聊@对象配置

MentionedUserConfig

字段	类型	说明
atAll	Boolean	是否 @ 所有人
userIds	`List<String>`	需要 @ 的用户 ID 列表

EscalateParam

字段	类型	说明
rank	Integer	升级通知策略级别，1，2，3, xx时间未响应升级到1级->2级->3级
condition	ClaimCondition	认领配置
notifyAction	NotifyAction	通知渠道信息

ClaimCondition

字段	类型	说明
condition	Integer	超过多长时间未认领
condition	Integer	认领后多久未恢复

NotifyAction

字段	类型	说明
channel	List< String >	通知渠道，phone:电话 , sms: 短信, email: 邮件
receiverType	String	接受者类型，user：用户，userGroup：用户组
users	List< User >	用户列表
userGroups	List< UserGroup>	用户组列表
webhookConfigList	List< CallbackConfig >	webhook 回调配置信息列表

RepeatNotifyConfig

字段	类型	说明
enabled	Boolean	是否开启重复通知
intervalHour	Integer	重复通知间隔小时数
intervalMin	Integer	重复通知间隔分钟数
maxCount	Integer	最大重复通知次数
strategy	String	重复通知策略

请求示例

Plain Text

1GET /v2/notify_rule?pageNo=1&pageSize=10 HTTP/1.1
2Host: cprom.bj.baidubce.com
3Content-Type: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8
5{
6    "orderBy": "updateTime",
7  "order": "desc",
8    "pageNo": 1,
9    "pageSize": 10,
10    "totalCount": 2,
11    "items": [
12        {
13            "notifyRuleId": "notify-********",
14            "notifyRuleName": "d-test",
15            "startTime": "00:00:00",
16            "endTime": "23:59:59",
17            "channel": [
18                "email"
19            ],
20            "receiverType": "user",
21            "users": [
22                {
23                    "userId": "2e*************************",
24                    "userName": "d*******",
25                    "userType": "",
26                    "phoneNumber": "",
27                    "email": ""
28                }
29            ],
30            "userGroups": [],
31            "webhookConfigList": [],
32            "createTime": "2024-05-14T14:22:21Z",
33            "updateTime": "2024-05-14T14:22:21Z"
34        },
35        {
36            "notifyRuleId": "notify-b*********",
37            "notifyRuleName": "d**",
38            "startTime": "00:00:00",
39            "endTime": "23:59:59",
40            "channel": [
41                "email"
42            ],
43            "receiverType": "userGroup",
44            "users": [],
45            "userGroups": [
46                {
47                    "groupId": "c************************",
48                    "groupName": "d-****",
49                    "description": ""
50                }
51            ],
52            "webhookConfigList": [],
53            "createTime": "2024-05-14T14:15:08Z",
54            "updateTime": "2024-05-14T14:15:09Z"
55        }
56    ]
57}

创建通知策略

请求方法 POST

请求路径：/v2/notify_rule

请求结构

Plain Text

1POST /v2/notify_rule  HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
notifyRuleName	String	是	Body参数	通知策略名称
startTime	String	是	Body参数	通知开始时间，时间格式 00：00：00
endTime	String	是	Body参数	通知结束时间，时间格式 23：59：59
channel	List< String >	否	Body参数	通知渠道，phone:电话 , sms: 短信, email: 邮件。若选择phone:电话 , sms: 短信, email: 邮件这三种方式通知则必选，webhook为非必选。
receiverType	String	否	Body参数	接受者类型，user：用户，userGroup：用户组，若选择phone:电话 , sms: 短信, email: 邮件这三种方式receiverType为必选参数，webhook为非必选。
users	List< User >	receiverType=user时必需	Body参数	用户列表
userGroups	List< UserGroup >	receiverType=userGroup时必需	Body参数	用户组列表
webhookConfigList	List< CallbackConfig >	否	Body参数	webhook 回调配置信息列表
escalateConfigList	List< EscalateParam >	否	Body参数	通知策略升级参数列表
repeatNotifyConfig	RepeatNotifyConfig	否	Body参数	重复通知配置

返回头域

除公共头域外，无其它特殊头域。

返回参数

参数名称	类型	描述
notifyRuleId	String	通知策略ID

请求示例

Plain Text

1POST /v2/notify_rule  HTTP/1.1
2Host: cprom.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
5{
6  "notifyRuleName": "test",
7  "startTime": "00:00:00",
8  "endTime": "23:59:59",
9  "receiverType": "user",
10  "channel": [
11    "email",
12    "phone"
13  ],
14  "users": [
15    {
16      "userId": "6***********************",
17      "userName": "w****25",
18      "userType": "identity",
19      "phoneNumber": "***********",
20      "email": "w****25@baidu.com"
21    }
22  ],
23  "userGroups": [],
24  "webhookConfigList": [
25        {
26            "webhookType": "custom",
27            "webhookList": [
28                {
29                    "hookName": "test",
30                    "hookMethod": "post",
31                    "hookUrl": "http://apiin.im.baidu.com/api/msg/groupmsgsend?access_token=dec67******************",
32                    "headers": null,
33                    "params": null
34                }
35            ]
36        }
37  ],
38  "escalateConfigList": [
39          {
40            "rank": 1,
41            "condition": {
42                "stayInUnclaimTime": 10
43            },
44            "notifyAction": {
45                "channel": [
46                    "phone"
47                ],
48                "receiverType": "userGroup",
49                "users": [],
50                "userGroups": [
51                    {
52                        "description": "",
53                        "groupId": "a0d*******************6",
54                        "groupName": "userGroupTest"
55                    }
56                ]
57            }
58        }
59   ]
60}

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8
5{
6  "notifyRuleId": "notify-*********"
7}

更新通知策略

请求方法 PUT

请求路径：/v2/notify_rule/{notifyRuleId}

请求结构

Plain Text

1PUT /v2/notify_rule/{notifyRuleId} HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
notifyRuleId	String	是	Path参数	通知策略ID
notifyRuleName	String	是	Body参数	通知策略名称
startTime	String	是	Body参数	通知开始时间，时间格式 00：00：00
endTime	String	是	Body参数	通知结束时间，时间格式 23：59：59
channel	List< String >	是	Body参数	通知渠道，phone:电话 , sms: 短信, email: 邮件
receiverType	String	是	Body参数	接受者类型，user：用户，userGroup：用户组
users	List< User >	receiverType=user时必需	Body参数	用户列表
userGroups	List< UserGroup >	receiverType=userGroup时必需	Body参数	用户组列表
webhookConfigList	List< CallbackConfig >	否	Body参数	webhook 回调配置信息列表
escalateConfigList	List< EscalateParam >	否	Body参数	通知策略升级参数列表
repeatNotifyConfig	RepeatNotifyConfig	否	Body参数	重复通知配置

返回头域

除公共头域外，无其它特殊头域。

返回参数

无

请求示例

Plain Text

1PUT /v2/notify_rule/notify-q9s***** HTTP/1.1
2Host: cprom.bj.baidubce.com
3Content-Type: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
5
6{
7  "notifyRuleName": "test",
8  "startTime": "00:00:00",
9  "endTime": "23:59:59",
10  "receiverType": "user",
11  "channel": [
12    "email",
13    "phone"
14  ],
15  "users": [
16    {
17      "userId": "6***************************",
18      "userName": "test25",
19      "userType": "identity",
20      "phoneNumber": "***********",
21      "email": "test25@baidu.com"
22    }
23  ]
24}

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8

查看通知策略

请求方法 GET

请求路径：/v2/notify_rule/{notifyRuleId}

请求结构

Plain Text

1GET /v2/notify_rule/{notifyRuleId}  HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
notifyRuleId	String	是	Path参数	通知策略ID

返回头域

除公共头域外，无其它特殊头域。

返回参数

参数名称	类型	描述
notifyRuleId	String	通知策略ID
notifyRuleName	String	通知策略名称
startTime	String	通知开始时间，时间格式 00：00：00
endTime	String	通知结束时间，时间格式 23：59：59
channel	List< String >	通知渠道，phone:电话 , sms: 短信, email: 邮件
receiverType	String	接受者类型，user：用户，userGroup：用户组
users	List< User >	用户列表
userGroups	List< UserGroup >	用户组列表
webhookConfigList	List< CallbackConfig >	webhook 回调配置信息列表
escalateConfigList	List< EscalateParam >	通知策略升级参数列表
repeatNotifyConfig	Object	重复通知配置
updateTime	String	更新时间

请求示例

Plain Text

1GET /v2/notify_rule/notify-q9sie****  HTTP/1.1
2Host: cprom.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8
5{
6    "notifyRuleId": "notify-q9si*****",
7    "notifyRuleName": "test",
8    "startTime": "00:00:00",
9    "endTime": "23:59:59",
10    "channel": [
11        "email"
12    ],
13    "receiverType": "user",
14    "users": [
15        {
16            "userId": "6****************************",
17            "userName": "test25",
18            "userType": "",
19            "phoneNumber": "168********",
20            "email": ""
21        }
22    ],
23    "userGroups": [],
24    "webhookConfigList": [],
25    "createTime": "2024-05-22T08:08:44Z",
26    "updateTime": "2024-05-22T08:08:44Z"
27}

删除通知策略

请求方法 DELETE

请求路径：/v2/notify_rule/{notifyRuleId}

请求结构

Plain Text

1DELETE /v2/notify_rule/{notifyRuleId}  HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
notifyRuleId	String	是	Path参数	通知策略ID

返回头域

除公共头域外，无其它特殊头域。

返回参数

无

请求示例

Plain Text

1DELETE /v2/notify_rule/notify-q9sie****  HTTP/1.1
2Host: cprom.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8

创建告警

请求方法 POST

请求路径：/v2/alerting_rule

请求结构

Plain Text

1POST /v2/alerting_rule?instanceId={instanceId}  HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

字段	类型	是否必需	参数位置	描述
instanceId	String	是	QueryString	Cprom实例ID
alertName	String	是	Body参数	告警名称
expr	String	是	Body参数	告警规则，promQL查询语句
for	String	是	Body参数	告警持续时间
description	String	是	Body参数	告警内容
notifyRuleId	String	是	Body参数	通知策略ID
enable	Boolen	否	Body参数	是否开启告警，创建时默认为true
severity	String	否	Body参数	告警级别，notice/warning/major/critical
labels	Map<Stirng,String>	否	Body参数	自定义label键值对
annotations	Map<Stirng,String>	否	Body参数	自定义注解键值对

返回头域

除公共头域外，无其它特殊头域。

返回参数

参数名称	类型	描述
alertId	String	告警规则ID

请求示例

Plain Text

1POST /v2/alerting_rule?instanceId=cprom-djskf******  HTTP/1.1
2Host: cprom.bj.baidubce.comContentType: application/jsonAuthorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
3{  
4    "alertName": "CCE-节点不可用报警",
5    "expr": "sum(kube_node_status_condition{condition=\"Ready\",status=\"false\",region=\"\", clusterID=~\"\"}) > 0",
6    "for": "2m",
7    "notifyRuleId": "notify-lv8c2ornb",
8    "severity": "notice",
9    "description": "cluster: {{ $labels.clusterID }}, region: {{ $labels.region }} SUM of node not Ready > 0, current: {{ $value | printf \"%.2f\" }}"
10}

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8
5{
6    "alertId": "alerting-*********"
7}

更新告警

请求方法 PUT

请求路径：/v2/alerting_rule/{alertingRuleId}

请求结构

Plain Text

1PUT /v2/alerting_rule/{alertingRuleId}?instanceId={instanceId}  HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

字段	类型	是否必需	参数位置	描述
alertingRuleId	String	是	Path参数	告警ID
instanceId	String	是	QueryString	Cprom实例ID
alertName	String	是	Body参数	告警名称
expr	String	是	Body参数	告警规则，promQL查询语句
for	String	是	Body参数	告警持续时间
description	String	是	Body参数	告警内容
notifyRuleId	String	是	Body参数	通知策略ID
severity	String	否	Body参数	告警级别，notice/warning/major/critical
enable	Boolen	否	Body参数	是否开启告警，开启为true，关闭为false
labels	Map<Stirng,String>	否	Body参数	自定义label键值对
annotations	Map<Stirng,String>	否	Body参数	自定义注解键值对

返回头域

除公共头域外，无其它特殊头域。

返回参数

无

请求示例

Plain Text

1PUT /v2/alerting_rule/alerting-sfo*****?instanceId=cprom-sdffjdk*****   HTTP/1.1
2Host: cprom.bj.baidubce.comContentType: application/jsonAuthorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
3{
4    "alertName": "CCE-节点不可用报警",
5    "expr": "sum(kube_node_status_condition{condition=\"Ready\",status=\"false\",region=\"\", clusterID=~\"\"}) > 0",
6    "for": "2m",
7    "enable": false,
8    "notifyRuleId": "notify-lv8c2ornb",
9    "severity": "notice",
10    "description": "cluster: {{ $labels.clusterID }}, region: {{ $labels.region }} SUM of node not Ready > 0, current: {{ $value | printf \"%.2f\" }}"
11}

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8

查看告警

请求方法 GET

请求路径：/v2/alerting_rule/{alertingRuleId}

请求结构

Plain Text

1GET /v2/alerting_rule/{alertingRuleId}?instanceId={instanceId}  HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
alertingRuleId	String	是	Path参数	告警ID
instanceId	String	是	QueryString	Cprom实例ID

返回头域

除公共头域外，无其它特殊头域。

返回参数

参数名称	类型	描述
alertId	String	告警ID
alertName	String	告警名称
expr	String	告警规则，promQL查询语句
for	String	告警持续时间
description	String	告警内容
enable	Boolen	是否开启告警
notifyRuleId	String	通知策略ID
severity	String	告警级别，取值为 `notice`、`warning`、`major`、`critical`
annotations	Map<Stirng,String>	注解列表，支持自定义注解

请求示例

Plain Text

1GET /v2/alerting_rule/alerting-sfo*****?instanceId=cprom-sdffjdk*****   HTTP/1.1
2Host: cprom.bj.baidubce.comContentType: application/jsonAuthorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8
5{
6    "alertId": "alerting-*********",
7    "alertName": "CCE-节点不可用报警2",
8    "expr": "sum(kube_node_status_condition{condition=\"Ready\",status=\"false\",region=\"\", clusterID=~\"\"}) > 0",
9    "for": "2m",
10    "description": "cluster: {{ $labels.clusterID }}, region: {{ $labels.region }} SUM of node not Ready > 0, current: {{ $value | printf \"%.2f\" }}",
11    "notifyRuleId": "notify-lv8c2ornb",
12    "labels": {
13        "cprom_severity": "notice"
14    }
15}

删除告警

请求方法 DELETE

请求路径：/v2/alerting_rule/{alertingRuleId}

请求结构

Plain Text

1DELETE /v2/alerting_rule/{alertingRuleId}?instanceId={instanceId}  HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
alertingRuleId	String	是	Path参数	告警ID
instanceId	String	是	QueryString	Cprom实例ID

返回头域

除公共头域外，无其它特殊头域。

返回参数

无

请求示例

Plain Text

1DELETE /v2/alerting_rule/alerting-sfo5*****?instanceId=cprom-u02*****  HTTP/1.1
2Host: cprom.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8

查看告警列表

请求方法 GET

请求路径：/v2/alerting_rule

请求结构

Plain Text

1GET /v2/alerting_rule?instanceId={instanceId}  HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
instanceId	String	是	QueryString	Cprom实例ID
pageSize	Integer	否	QueryString	分页查询监控实例列表每页监控实例个数，范围为1-100，缺省值为10
pageNo	Integer	否	QueryString	分页查询监控实例列表分页页码数，缺省值为1
keywordType	String	否	QueryString	筛选条件类型，默认为alertName，只支持alertName
keyword	String	否	QueryString	筛选条件关键字

返回头域

除公共头域外，无其它特殊头域。

返回参数

参数名称	类型	描述
keywordType	String	筛选条件类型
keyword	String	筛选条件关键字
orderBy	String	告警列表排序依据字段
order	String	告警列表排序方式：desc倒序，asc升序
pageNo	Integer	分页当前页码数
pageSize	Integer	当前页告警个数
totalCount	Integer	告警总个数
items	List< RuleDetail >	告警列表

RuleDetail：

字段	类型	描述
alertId	String	告警ID
alertName	String	告警名称
expr	String	告警规则，promQL查询语句
for	String	告警持续时间
description	String	告警内容
enable	Boolen	是否开启告警
notifyRuleId	String	通知策略ID
severity	String	告警级别，取值为 `notice`、`warning`、`major`、`critical`
annotations	Map<Stirng,String>	注解列表

请求示例

Plain Text

1GET /v2/alerting_rule?instanceId=cprom-sdffjdk*****&keywordType=alertName&keyword=scrapejob-exidjf-cce-esfsf HTTP/1.1
2Host: cprom.bj.baidubce.comContentType: application/jsonAuthorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8
5{
6  "keywordType": "alertName",
7    "keyword": "scrapejob-cce-*****",
8    "pageNo": 1,
9    "pageSize": 10,
10    "totalCount": 1,
11    "items": [
12        {
13            "alertId": "alerting-********",
14            "alertName": "scrapejob-cce-*****",
15            "expr": "sum(kube_node_status_condition{condition=\"Ready\",status=\"false\",region=\"\", clusterID=~\"\"}) > 0",
16            "for": "2m",
17            "description": "cluster: {{ $labels.clusterID }}, region: {{ $labels.region }} SUM of node not Ready > 0, current: {{ $value | printf \"%.2f\" }}",
18            "notifyRuleId": "notify-********",
19            "labels": {
20                "cprom_severity": "notice"
21            }
22        }
23    ]        
24}

评价此篇文章

有帮助没帮助

关联集群接口

错误返回

百度智能云

Prometheus监控服务 CProm

Prometheus监控服务 CProm

告警相关接口

查询告警模板列表

查询通知策略列表

NotifyRule

User

UserGroup

CallbackConfig

WebhookDetail

MentionedUserConfig

EscalateParam

ClaimCondition

NotifyAction

RepeatNotifyConfig

创建通知策略

更新通知策略

查看通知策略

删除通知策略

创建告警

更新告警

查看告警

删除告警

查看告警列表