获取下载任务列表ListDownloadTask
更新时间：2026-06-23
- 获取当前用户下载任务列表。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v{version}/logstore/download/list HTTP/1.1
2Host: xxx.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "project": <project>,
7 "logStoreName": <logStoreName>,
8 "orderBy": <orderBy>,
9 "order": <order>,
10 "pageSize": <pageSize>,
11 "pageNo": <pageNo>
12}请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值为2 |
| project | String | 否 | RequestBody参数 | 日志组名称关键字查询，精确匹配 |
| logStoreName | String | 否 | RequestBody参数 | 日志集关键字查询，模糊匹配 |
| orderBy | String | 否 | RequestBody参数 | 排序字段，默认按照创建时间排序，支持createdTime: 创建时间，updatedTime: 修改时间, name: 名称 |
| order | String | 否 | RequestBody参数 | 排序顺序，desc为降序，asc为升序，默认为 desc |
| pageNo | Int | 否 | RequestBody参数 | 起始页码，默认为 1 |
| pageSize | Int | 否 | RequestBody参数 | 每页显示数据大小，默认为 10 |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 请求是否成功 |
| code | String | 请求码，成功为OK，错误为具体的错误码 |
| message | String | 请求成功为空，失败为具体的错误信息 |
| result | DownloadTaskListResult | 结果对象 |
请求示例
Plain Text
1POST /v2/logstore/download/list HTTP/1.1
2HOST bls-log.bj.baidubce.com
3Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
4
5{
6 "project": "",
7 "logStoreName": "",
8 "orderBy": "createdTime",
9 "order": "desc",
10 "pageSize": 10,
11 "pageNo": 1
12}响应示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Wed, 10 Apr 2016 08:26:52 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
7
8{
9 "code": "OK",
10 "success": true,
11 "result": {
12 "tasks": [
13 {
14 "uuid": "96b92fe6-3f40-5fe8-3a7f-3fe168b38cc5",
15 "name": "test",
16 "project": "default",
17 "logStoreName": "test",
18 "logStreamName": "",
19 "query": "match *",
20 "queryStartTime": "2024-11-04T06:00:00Z",
21 "queryEndTime": "2024-11-04T06:05:00Z",
22 "format": "json",
23 "limit": 100,
24 "order": "desc",
25 "state": "SUCCESS",
26 "failedCode": "",
27 "failedMessage": "",
28 "writtenRows": 100,
29 "fileDir": "bls-test/wang/download/",
30 "fileName": "test_json_96b92fe6-3f40-5fe8-3a7f-3fe168b38cc5.json",
31 "execStartTime": "2024-11-05T07:37:12Z",
32 "execEndTime": "2024-11-05T07:37:14Z",
33 "createdTime": "2024-11-05T07:37:12Z",
34 "updatedTime": "2024-11-05T07:37:14Z"
35 }
36 ],
37 "total": 1,
38 "orderBy": "createdTime",
39 "order": "desc",
40 "pageNo": 1,
41 "pageSize": 10
42 }
43}评价此篇文章