查询任务列表
更新时间：2025-08-22
本接口用于查询任务列表，接口返回任务分页结果，任务信息仅包含基础信息。
接口限制：
- marker 和 maxSize 两个参数影响单次分页查询结果数。特别注意：当这2个值都缺省时，本接口最多只返回前10条查询结果。
- 只能查询到最近7天（7*24小时）内的任务。
请求结构
Http
1GET /v2/tasks?{请求参数} HTTP/1.1
2connection: keep-alive
3host: vod.bj.baidubce.com
4content-type: application/json
5x-bce-request-id: <bce-request-id>
6x-bce-date: <utc-date-string>
7authorization: <bce-authorization-string> 在线调试
平台提供了 API在线调试平台-示例代码 ，用于帮助开发者调试接口，平台集成快速检索、查看在线调用的请求内容和返回结果、复制和下载示例代码等功能，简单易用，更多内容请查看API在线调试介绍。
请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| marker | string | 否 | Query参数 | 本次请求的marker，标记查询的起始位置，是上次marker机制查询返回的nextMarker，首次查询不提供本字段 |
| maxSize | string | 否 | Query参数 | 本次请求返回的任务列表的最大元素个数，支持范围：[1-100]，默认值：10 |
| taskId | string | 否 | Query参数 | 任务ID |
| mediaId | string | 否 | Query参数 | 媒资ID |
| type | string | 否 | Query参数 | 任务类型，包括
|
| status | string | 否 | Query参数 | 任务状态，包括
|
| beginTime | string | 否 | Query参数 | 任务创建时间的开始时间，大于等于开始时间，格式参考日期与时间规范 |
| endTime | string | 否 | Query参数 | 任务创建时间的开始时间，小于等于结束时间，格式参考日期与时间规范 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| isTruncated | boolean | 下一页是否还有数据 |
| marker | string | 当前页查询的marker |
| nextMarker | string | 查询下一页的marker |
| data | MediaTaskBasicInfo[] | 此页数据 |
示例
获取处理失败的任务列表
第一次搜索时不需要指定marker，从起始开始搜索。
请求内容
Http
1GET /v2/tasks?maxSize=10&status=FAILED HTTP/1.1
2host: vod.bj.baidubce.com
3accept: */*
4connection: keep-alive
5content-type: application/json
6x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
7x-bce-date: 2024-03-24T13:08:44Z
8authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2024-03-24T13:08:44Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9返回内容
Http
1HTTP/1.1 200 OK
2Transfer-Encoding: chunked
3x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
4Cache-Control: no-cache
5Date: Tue, 24 Mar 2024 13:08:44 GMT
6Content-Type: application/json;charset=UTF-8
7
8{
9 "data": [
10 {
11 "taskId": "tsk-emeqb9c1kmdd7rns",
12 "mediaId": "mda-emcventhizk2yfbz",
13 "type": "WORKFLOW",
14 "status": "FAILED",
15 "createTime": "2024-12-05T06:08:41Z",
16 "finishTime": "2024-12-05T06:08:43Z"
17 },
18 {
19 "taskId": "tsk-emeq6k7m52p8d2u0",
20 "mediaId": "mda-emcvg7qrib0xq2y5",
21 "type": "PRESET",
22 "status": "FAILED",
23 "createTime": "2024-12-05T06:08:27Z",
24 "finishTime": "2024-12-05T06:08:37Z"
25 }
26 ],
27 "marker": "tsk-emeqb9c1kmdd7rns",
28 "nextMarker": "tsk-emeq6k7m52p8d2u0",
29 "isTruncated": false
30}返回结果的isTruncated为false，表示没有下一页数据了，运行中的任务一共2个。
错误码
详见公共错误返回。