报警历史相关接口
更新时间：2025-08-20
报警历史相关接口
报警历史列表查询接口
接口描述
该接口可获取云产品监控、站点监控等相关报警的报警历史列表信息。
请求参数
| 名称 | 类型 | 描述 | 是否必须 | 参数位置 |
|---|---|---|---|---|
| userId | String | 用户id | 是 | RequestBody参数 |
| alarmType | String | 警报类型，必填，可选值: ALARM_TYPE_CLOUD (云产品监控) ALARM_TYPE_SITE (站点监控) ALARM_TYPE_CUSTOM (自定义监控) ALARM_TYPE_APP (应用监控) |
是 | RequestBody参数 |
| pageNo | Int | 第几页，从1开始计数，必填 | 是 | RequestBody参数 |
| pageSize | Int | 每页展示数量，必填，最大值：100 | 是 | RequestBody参数 |
| startTime | Int | 起始时间，Unix时间戳，单位：毫秒，选填，若未设置，默认为40天前 | 否 | RequestBody参数 |
| endTime | Int | 结束时间，Unix时间戳，单位：毫秒，选填，若未设置，默认为当前时间 | 否 | RequestBody参数 |
| scope | String | 云产品，选填，若未设置，表示返回所有云产品的警报 | 否 | RequestBody参数 |
| resourceType | String | 监控对象类型，选填，若未设置，表示返回所有监控对象类型的警报 | 否 | RequestBody参数 |
| states | List<String> | 警报状态，选填，可同时筛选多个状态，若未设置，表示返回所有状态的警报，可选值: OK (恢复正常) ALERT (异常中) INSUFFICIENT_DATA (数据不足) CLOSED (已关闭) |
否 | RequestBody参数 |
| sort | String | 排序字段, 选填，若未设置，默认为startTime，可选项： startTime |
否 | RequestBody参数 |
| ascending | Boolean | 是否升序，选填，默认false | 否 | RequestBody参数 |
| level | String | 报警等级，选填，若未设置，表示返回所有等级的警报，可选值： ALARM_LEVEL_NOTICE (通知) ALARM_LEVEL_WARNING (警报) ALARM_LEVEL_MAJOR (重要) ALARM_LEVEL_CRITICAL (严重) |
否 | RequestBody参数 |
| region | String | 地域，选填，若未设置，表示返回所有地域的警报 | 否 | RequestBody参数 |
| alarmAliasName | String | 按策略名模糊查询，选填 | 否 | RequestBody参数 |
| resource | ResourceKV | 按实例进行搜索，选填 | 否 | RequestBody参数 |
| resources | List<ResourceKV> | 按多个实例进行搜索，选填 | 否 | RequestBody参数 |
ResourceKV
| 名称 | 类型 | 描述 | 是否必须 | 参数位置 |
|---|---|---|---|---|
| InstanceId | String | 实例id，选填 | 否 | RequestBody参数 |
| taskId | String | 站点监控任务id，填写taskId指定站点监控任务 | 否 | RequestBody参数 |
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 请求是否成功 |
| msg | String | 若失败，返回失败原因 |
| result | PageResult | 按页封装结果 |
PageResult
| 名称 | 类型 | 描述 |
|---|---|---|
| alarms | List<Alarm> | 报警历史列表 |
| pageNo | Int | 页码编号 |
| pageSize | Int | 页面大小 |
| totalCount | Int | 报警历史历史总共个数 |
请求示例
JAVA
1// build client
2String endpoint = "http://bcm.bj.baidubce.com";
3String userId = "a0d04d7c***************7b6752ce4";
4String ak = "ALTAK***************3hVCYG";
5String sk = "b2c53*******************f9993ac1";
6
7BcmClientConfiguration config = new BcmClientConfiguration();
8config.setCredentials(new DefaultBceCredentials(ak, sk));
9config.setEndpoint(endpoint);
10bcmClient = new BcmClient(config);
11
12AlarmListRequest request = new AlarmListRequest();
13request.setUserId(userId);
14request.setAlarmType("ALARM_TYPE_CLOUD");
15request.setPageNo(1);
16request.setPageSize(10);
17request.setRegion("bj");
18request.setScope("BCE_BCC");
19request.setStartTime(1722844725412L);
20request.setEndTime(1723449525412L);
21
22AlarmListResponse alarmList = bcmClient.getAlarmList(request);
23
24
25
26// Response
27{
28 "result": {
29 "alarms": [
30 {
31 "id": "9f7718dd**********82675ee",
32 "seriesId": "8e7e040**********994c40198097c0",
33 "startTime": 1723446539999,
34 "state": "OK",
35 "userId": "a0d04**********52ce4",
36 "endTime": 1723446599999,
37 "initState": "ALERT",
38 "policy": {
39 "aliasName": "qgg**********",
40 "content": "CPU使用率1分钟内平均值>3%，连续发生1次触发报警",
41 "contentEn": "the average of CPUUsagePercent within 1 minute > 3%, occurring 1 time in a row",
42 "name": "b905**********b343f"
43 },
44 "resource": {
45 "identifiers": {
46 "InstanceId": "i-21**********N"
47 },
48 "properties": {
49 "application": "bcc",
50 "shortInstanceId": "i-21**********N"
51 },
52 "region": "bj",
53 "resourceType": "Instance",
54 "scope": "BCE_BCC"
55 },
56 "actions": [
57 {
58 "alias": "li**********",
59 "callBacks": [
60 "http://api*******************4790b0"
61 ],
62 "executedTime": 1723446605,
63 "members": [
64 "li**********"
65 ],
66 "name": "li**********",
67 "notifications": [
68 "EMAIL"
69 ],
70 "type": "ACTION_TYPE_ALERT"
71 }
72 ]
73 }
74 ],
75 "pageNo": 1,
76 "pageSize": 1,
77 "totalCount": 5039
78 },
79 "success": true
80}报警历史详情查询接口
请求描述
可以根据报警id来获取报警的详情信息
请求参数
| 名称 | 类型 | 描述 | 是否必须 | 参数位置 |
|---|---|---|---|---|
| userId | String | 用户ID | 是 | RequestBody参数 |
| alarmId | String | 警报id，全局唯一, 可以从报警历史列表接口获取 | 是 | RequestBody参数 |
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 请求是否成功 |
| msg | String | 若失败，返回失败原因 |
| result | Alarm | 报警详情内容 |
请求示例
JAVA
1// build client
2String endpoint = "http://bcm.bj.baidubce.com";
3String userId = "a0d04d7c***************7b6752ce4";
4String ak = "ALTAK***************3hVCYG";
5String sk = "b2c53*******************f9993ac1";
6
7BcmClientConfiguration config = new BcmClientConfiguration();
8config.setCredentials(new DefaultBceCredentials(ak, sk));
9config.setEndpoint(endpoint);
10bcmClient = new BcmClient(config);
11
12AlarmDetailRequest request = new AlarmDetailRequest();
13request.setAlarmId("4d38c9**********c4ede387");
14request.setUserId(userId);
15
16AlarmDetailResponse alarmDetail = bcmClient.getAlarmDetail(request);
17
18
19// Response
20{
21 "success": true,
22 "result": {
23 "id": "4d38c9**********c4ede387",
24 "seriesId": "8e7e04034**********198097c0",
25 "userId": "a0d04**********752ce4",
26 "initState": "ALERT",
27 "state": "OK",
28 "closeReason": null,
29 "startTime": 1723531319999,
30 "endTime": 1723531379999,
31 "resource": {
32 "scope": "BCE_BCC",
33 "resourceType": "Instance",
34 "region": "bj",
35 "identifiers": {
36 "InstanceId": "i-21**********N"
37 },
38 "properties": {
39 "application": "bcc",
40 "shortInstanceId": "i-21**********N"
41 }
42 },
43 "policy": {
44 "name": "b905**********b343f",
45 "aliasName": "q**********",
46 "content": "CPU使用率1分钟内平均值>3%，连续发生1次触发报警",
47 "contentEn": "the average of CPUUsagePercent within 1 minute > 3%, occurring 1 time in a row"
48 },
49 "actions": [
50 {
51 "type": "ACTION_TYPE_ALERT",
52 "name": "li**********",
53 "executedTime": 1723531384,
54 "alias": "li**********",
55 "notifications": [
56 "EMAIL",
57 "SMS"
58 ],
59 "callBacks": [
60 "http://api*******************4790b0"
61 ],
62 "members": [
63 "li**********"
64 ]
65 }
66 ],
67 "alertMetrics": [
68 {
69 "metric": {
70 "name": "CPUUsagePercent",
71 "value": 3,
72 "aliasName": "CPU使用率1分钟内平均值",
73 "aliasNameEn": "1 min average of CPUUsagePercent",
74 "unit": "%"
75 },
76 "rule": {
77 "seq": 0,
78 "operator": "OPERATOR_TYPE_GT",
79 "threshold": 3
80 }
81 }
82 ]
83 }
84}附录
Alarm
| 名称 | 类型 | 描述 |
|---|---|---|
| id | String | 警报id，全局唯一 |
| seriesId | String | 用户id |
| userId | String | 警报序列id |
| initState | String | 初始警报状态，可能值： OK (恢复正常) ALERT (异常中) INSUFFICIENT_DATA (数据不足) CLOSED (已关闭) |
| state | String | 当前状态，一个警报最多有两个状态，若当前状态=初始状态，表示警报仍停留在初始状态 |
| closeReason | String | 若警报已关闭，该字段填写关闭原因，可能值： INSUFFICIENT_DATA (无数据) POLICY_MODIFIED (策略更改或删除) |
| startTime | Int | 警报开始时间，Unix时间戳，单位：毫秒 |
| endTime | Int | 警报结束时间，Unix时间戳，单位：毫秒，若警报未结束，该字段填0 |
| resource | Resource | 警报关联的资源 |
| policy | Policy | 报警对应的报警策略 |
| actions | List<Action> | 报警动作列表 |
| alertMetrics | List<AlertMetrics> | 触发报警的指标信息，查询历史详情时会返回 |
Resource
| 名称 | 类型 | 描述 |
|---|---|---|
| scope | String | 所属云产品 |
| resourceType | String | 云产品子资源类型 |
| region | String | 地域 |
| identifiers | Map<String, String> | 资源标识，不同云产品有不同的标识符 |
| properties | Map<String, String> | 资源属性，不同云产品有不同的资源属性 |
Policy
| 名称 | 类型 | 描述 |
|---|---|---|
| name | String | 策略名，用于查询策略详情 |
| aliasName | String | 策略显示名 |
| content | String | 策略内容 |
| contentEn | String | 英文策略内容 |
| extra | Map<String, String> | 报警策略的一些额外属性，如果存在会返回 |
Action
| 名称 | 类型 | 描述 |
|---|---|---|
| type | String | 动作类型，可选值： ACTION_TYPE_OK (恢复通知) ACTION_TYPE_ALERT (异常通知) ACTION_TYPE_INSUFFICIENT_DATA (数据不足通知) ACTION_TYPE_CALLBACK (报警回调) |
| name | String | 动作名称，当type=ACTION_TYPE_CALLBACK，该字段填写回调地址 |
| executedTime | Int | 动作执行时间，Unix时间戳，单位：毫秒，若该字段为0或未设置，表示动作未执行 |
| alias | String | 通知模板名称 |
| notifications | List<String> | 通知的方式，仅包括三种：邮件、短信、电话 |
| callBacks | List<String> | 报警回调链接 |
| members | List<String> | 用户/用户组信息 |
AlertMetrics
| 名称 | 类型 | 描述 |
|---|---|---|
| metric | Metric | 触发报警的指标信息 |
| rule | Rule | 触发指标报警的规则 |
Metric
| 名称 | 类型 | 描述 |
|---|---|---|
| name | String | 指标名称 |
| value | Int | 报警触发时的指标值 |
| dimensions | Map<String,String> | 指标维度 |
| aliasName | String | 指标中文名 |
| aliasNameEn | String | 指标英文名 |
| unit | String | 指标单位 |
Rule
| 名称 | 类型 | 描述 |
|---|---|---|
| seq | Int | 规则报警策略中的序列，seq相同，表示是同一个规则 |
| operator | String | 比较方式，可能值： OPER_TYPE_GT(大于) OPER_TYPE_GE(大于等于) OPER_TYPE_LT(小于) OPER_TYPE_LE(小于等于) OPER_TYPE_EQ(等于) OPER_TYPE_NE(不等于) 环比上升: OPER_TYPE_INC_RATE_GT(环比上周期增长大于) OPER_TYPE_INC_RATE_GE(环比上周期增长大于等于) OPER_TYPE_INC_RATE_LT(环比上周期增长小于) OPER_TYPE_INC_RATE_LE(环比上周期增长小于等于) OPER_TYPE_INC_RATE_EQ(环比上周期增长等于) OPER_TYPE_INC_RATE_NE(环比上周期增长不等于) 环比下降: OPER_TYPE_DEC_RATE_GT(环比上周期下降大于) OPER_TYPE_DEC_RATE_GE(环比上周期下降大于等于) OPER_TYPE_DEC_RATE_LT(环比上周期下降小于) OPER_TYPE_DEC_RATE_LE(环比上周期下降小于等于) OPER_TYPE_DEC_RATE_EQ(环比上周期下降等于) OPER_TYPE_DEC_RATE_NE(环比上周期下降不等于) |
| threshold | Int | 报警阈值 |