查询预期事件列表
更新时间：2026-06-22
该接口用于查询预期事件信息。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /?action=DescribePlannedEvents HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "serverEventStatus" : serverEventStatus,
7 "serverEventIds" : [serverEventId],
8 "instanceIds" : [instanceId],
9 "productCategory" : productCategory,
10 "serverEventType" : serverEventType,
11 "serverEventLogTimeFilter" : serverEventLogTimeFilter,
12 "periodStartTime" : periodStartTime,
13 "periodEndTime" : periodEndTime,
14 "maxKeys" : maxKeys,
15 "marker" : marker
16}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| action | String | 是 | Query参数 | 对实例执行的动作，本接口中该参数取值：DescribePlannedEvents |
| serverEventStatus | String | 否 | RequestBody参数 | 事件状态，支持状态：Inquiring，Processing，Executing，Executed，Abnormal，DisConfirm |
| 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=DescribePlannedEvents HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de返回示例
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": "8d9a70cb-f82d-44ac-a12f-8bfe130a5602",
9 "isTruncated": true,
10 "marker": "",
11 "maxKeys": 1,
12 "nextMarker": "event-UaQsSXg2",
13 "plannedMaintenanceEvents": [
14 {
15 "serverEventId": "event-zE2IDo37",
16 "serverEventType": "CustomScheduleInstanceRebootEvent",
17 "serverEventStatus": "Processing",
18 "instanceId": "i-coGiCHZs",
19 "productCategory": "BCC",
20 "instanceSpec": null,
21 "instanceName": null,
22 "privateIp": null,
23 "tags": [],
24 "serverEventCreatedTime": "2025-10-29T09:18:28Z",
25 "serverEventEndedTime": null,
26 "maintenanceOptions": [
27 "Reboot"
28 ],
29 "supportMaintenanceOptions": [],
30 "authorizedMaintenanceOperation": "Repair",
31 "associatedPlannedMaintenanceServerEventIds": [],
32 "associatedUnplannedMaintenanceServerEventIds": [
33 "event-ATUOTTEJ"
34 ],
35 "executeTime": "2025-10-29T11:24:21Z",
36 "serverEventLogs": [
37 {
38 "name": "EventCreate",
39 "operator": "系统",
40 "operateTime": "2025-10-29T09:18:29Z"
41 },
42 {
43 "name": "EventAuthorize",
44 "operator": "用户",
45 "operateTime": "2025-10-29T11:24:33Z"
46 }
47 ],
48 "risks": [
49 {
50 "issueName": "issueName",
51 "issueAlias": null,
52 "issueEffect": "issueEffect",
53 "issueDescription": "issueDescription",
54 "issueOccurTime": "2025-02-17T20:16:31Z",
55 "issueSource": null
56 }
57 ]
58 }
59 ]
60}评价此篇文章