查询预期事件记录列表
更新时间：2026-06-22
该接口用于查询已完成的预期内事件
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /?action=DescribePlannedEventRecords HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "serverEventIds" : [serverEventId],
7 "instanceIds" : [instanceId],
8 "productCategory" : productCategory,
9 "serverEventType" : serverEventType,
10 "serverEventLogTimeFilter" : serverEventLogTimeFilter,
11 "periodStartTime" : periodStartTime,
12 "periodEndTime" : periodEndTime,
13 "maxKeys" : maxKeys,
14 "marker" : marker
15}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| action | String | 是 | Query参数 | 对实例执行的动作，本接口中该参数取值：DescribePlannedEventRecords |
| serverEventIds | List<String> | 否 | RequestBody参数 | 维修事件的id列表 |
| instanceIds | List<String> | 否 | RequestBody参数 | 虚机的短id列表 |
| productCategory | String | 否 | RequestBody参数 | 故障实例产品类型 （BBC / BCC / HPAS） |
| serverEventType | String | 否 | RequestBody参数 | 事件类型，支持类型：InstanceRepairBySystemFailureEvent，InstanceRepairOrFastRepairBySystemFailureEvent，LocalDiskInstanceRepairBySystemFailureEvent，LocalDiskInstanceRepairOrFastRepairBySystemFailureEvent |
| serverEventLogTimeFilter | String | 否 | RequestBody参数 | 根据事件操作日志的类型查询periodStartTime和periodEndTime范围内的事件，支持类型：EventCreate、EventAuthorize、EventExecuting、RejectCheckResult |
| periodStartTime | String | 否 | RequestBody参数 | timeFilter类型开始时间, 若为空则只按照periodEndTime限制，符合BCE规范的日期格式 |
| periodEndTime | String | 否 | RequestBody参数 | timeFilter类型结束时间, 若为空则只按照periodStartTime限制，符合BCE规范的日期格式 |
| maxKeys | int | 否 | RequestBody参数 | 每页包含的最大数量，最大数量通常不超过100，缺省值为10 |
| marker | String | 否 | RequestBody参数 | 批量获取列表的查询的起始事件id |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| requestId | String | 请求Id |
| isTruncated | Boolean | true表示后面还有数据，false表示已经是最后一页 |
| marker | String | 标记查询的起始位置 |
| maxKeys | int | 每页包含的最大数量 |
| nextMarker | String | 获取下一页所需要传递的marker值。当isTruncated为false时，该域不出现 |
| plannedMaintenanceEvents | List<PlannedEventResponse> | 非预期事件列表 |
请求示例
Plain Text
1POST /?action=DescribePlannedEventRecords HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5{
6 "maxKeys": 1
7}返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Wed, 03 Dec 2014 06:42:19 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS
6
7{
8 "requestId": "08825bf5-378a-40c6-a0bd-6f20e9f264a3",
9 "isTruncated": true,
10 "marker": "",
11 "maxKeys": 1,
12 "nextMarker": "event-ZKcXnfN5",
13 "plannedMaintenanceEvents": [
14 {
15 "serverEventId": "event-RHjECCXP",
16 "serverEventType": "CustomScheduleInstanceRepairOrFastRepairEvent",
17 "serverEventStatus": "Abnormal",
18 "instanceId": "i-NNkaK46e",
19 "productCategory": "BCC",
20 "instanceSpec": null,
21 "instanceName": null,
22 "privateIp": null,
23 "tags": [],
24 "serverEventCreatedTime": "2025-10-29T08:31:17Z",
25 "serverEventEndedTime": null,
26 "maintenanceOptions": [
27 "Repair",
28 "FastRepair"
29 ],
30 "supportMaintenanceOptions": [
31 "Repair",
32 "FastRepair"
33 ],
34 "authorizedMaintenanceOperation": "",
35 "associatedPlannedMaintenanceServerEventIds": [
36 "event-UaQsSXg2"
37 ],
38 "associatedUnplannedMaintenanceServerEventIds": [],
39 "executeTime": "1971-01-01T00:00:01Z",
40 "serverEventLogs": [
41 {
42 "name": "EventCreate",
43 "operator": "系统",
44 "operateTime": "2025-10-29T08:31:23Z"
45 }
46 ],
47 "risks": [
48 {
49 "issueName": "VERSION_UPDATE",
50 "issueAlias": null,
51 "issueEffect": "issueEffect",
52 "issueDescription": "issueDescription",
53 "issueOccurTime": "2025-02-17T20:16:31Z",
54 "issueSource": null
55 }
56 ]
57 }
58 ]
59}评价此篇文章