Maintenance Records Related Interfaces
Updated at:2025-10-20
The service domain name for the maintenance platform, a global service API, is: bbc.bj.baidubce.com
Maintenance records (closed maintenance tasks)
Query maintenance records (closed maintenance tasks)
Request structure
Plain Text
1GET /v{version}/closedTask?marker={marker}&maxKeys={maxKeys}&startTime={startTime}&endTime={endTime} HTTP/1.1
2Host: bbc.bj.baidubce.com
3Authorization: authorization string
Request headers
There are no special headers required beyond the common headers.
Request parameters
| Parameter name | Types | Whether required | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number |
| marker | String | No | Query | The starting position of the batch list query is a system-generated string |
| maxKeys | int | No | Query | The maximum number of items per page is 1,000, with a default value of 1,000. |
| instanceId | String | No | Query | ID of the faulty instance |
| serviceType | String | No | Query | Type of the faulty instance |
| taskId | String | No | Query | Maintenance task ID |
| timeRangeType | String | No | Request Body parameters | Time node type. Current supported types: errStart, newTask, authorizeTask, unAuthorizeTask |
| timeRangeStart | String | No | Request Body parameters | Start time for timeRangeType, e.g., 2021-06-29 19:00:00. If left empty, only timeRangeEnd will apply. |
| timeRangeEnd | String | No | Request Body parameters | End time for timeRangeType, e.g., 2021-06-29 19:00:00. If left empty, only timeRangeStart will apply. |
Response headers
No special headers are required beyond the standard ones.
Response parameters
| Parameter name | Types | Description |
|---|---|---|
| marker | String | Mark the starting position of the query. |
| isTruncated | boolean | true indicates there is more data later, false indicates it is the last page |
| nextMarker | String | The marker value needed to fetch the next page. This field is absent when isTruncated is false. |
| maxKeys | int | Maximum number of items included per page |
| RepairTask | List<[ClosedTaskModel](BCC/API Reference/Appendix.md#ClosedTaskModel)> | Maintenance task information, a collection composed of TaskModel |
Error codes
No special error codes are returned
Request example
Plain Text
1GET /v2/closedTask?marker=task-tv9xpdWi&maxKeys=1&startTime=2021-06-29 19:00:00&endTime=2021-07-07 10:26:35 HTTP/1.1
2Host: bbc.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
Response example
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 "nextMarker": "task-xktdeMSf",
9 "marker": "task-tv9xpdWi",
10 "maxKeys": 1,
11 "isTruncated": true,
12 "RepairTask": [
13 {
14 "instanceId": "i-V541twDm",
15 "errResult": "test error",
16 "createTime": "2020-07-30T14:10:39Z",
17 "taskId": "task-tv9xpdWi",
18 "endTime": "2020-07-30T17:03:28Z"
19 }
20 ]
21}
