获取工作流列表
更新时间：2025-08-07
接口描述
获取基于游标(工作流ID)分页的工作流列表
权限说明
用户获取工作空间下工作流WORKFLOW列表，需具有以下任一权限
- 查看工作流的权限：查看
VIEW - 运行工作流的权限: 运行
EXECUTE - 编辑工作流的权限：编辑
MODIFY - 管理工作流的权限：管理
MANAGE
注意事项
- 工作空间不存在，获取工作流列表会失败
- maxKeys在合法范围[1, 100]之外，获取工作流列表会失败
请求结构
Plain Text
1GET /v2/workspaces/{workspaceId}/job?marker=jid_1234567890&maxKeys=10 HTTP/1.1
2Host: databuilder.bd.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域
请求参数
| 参数名 | 类型 | 是否必填 | 参数位置 | 说明 |
|---|---|---|---|---|
| workspaceId | String | 是 | Path参数 | 工作空间ID，不允许为空或者只包含空白字符 |
| marker | String | 否 | Query参数 | 工作流ID，默认为按照字母序第一个工作流id开始查询 |
| maxKeys | int | 否 | Query参数 | 每页最多展示多少条工作流，取值范围[1, 100]， 默认为10 |
响应头域
除公共头域外，无其它特殊头域
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| requestId | String | 请求ID |
| code | String | 响应码 |
| message | String | 响应描述信息 |
| result | ListJobResult | 工作流列表 |
错误码
| 错误码 | 错误描述 | HTTP状态码 | 中文解释 |
|---|---|---|---|
| AccessDenied | 无操作权限 | 403 | 暂无操作权限 |
| IllegalArgument | 参数非法 | 400 | 1. workspace不存在 2. workspaceId未提供 3. 非法的maxKeys值 |
| InternalError | 内部错误 | 500 | marker未提供 |
请求示例
Plain Text
1GET https://databuilder.bd.baidubce.com/v2/workspaces/workspace_9862_0763f283d58a/job?marker=jid_be7208a1b1b3523c&maxKeys=2
2
3X-Region: bd
4X-Via: api-gateway
5Authorization: xxxxxx
6Host: host
7X-Bce-Request-Id: 75f4d4ad-d478-4494-95cd-74449a33365a
8Accept: */*
9Accept-Encoding: gzip, deflate, br
10Connection: keep-alive响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json
3Transfer-Encoding: chunked
4Date: Mon, 28 Jul 2025 05:36:55 GMT
5Keep-Alive: timeout=180
6Connection: keep-alive
7{
8 "requestId": "24926dae-1f23-4ec2-ab19-c655de1bced0",
9 "code": "SUCCESS",
10 "result": {
11 "marker": "jid_be7208a1b1b3523c",
12 "isTruncated": true,
13 "nextMarker": "jid_be867096f82f2c94",
14 "maxKeys": 2,
15 "jobs": [
16 {
17 "jobId": "jid_be7f745a638b8801",
18 "workspaceId": "workspace_9862_0763f283d58a",
19 "name": "复制测试-copy-copy-copy-copy-copy-copy-copy-copy-copy-20250326-193256",
20 "tasks": []
21 },
22 {
23 "jobId": "jid_be867096f82f2c94",
24 "workspaceId": "workspace_9862_0763f283d58a",
25 "name": "视频生文工作流模版-template-20250421-164120111",
26 "description": "jd-template",
27 "tasks": [
28 {
29 "name": "DataFlowTask1",
30 "id": "tid-1",
31 "description": "desc",
32 "clusterList": [
33 {
34 "clusterId": "compute_b5c3_bdce634bca30",
35 "engineType": "RAY",
36 "clusterType": "RESIDENT"
37 }
38 ],
39 "compoundTask": {
40 "taskParam": {
41 "parallel": 1
42 },
43 "operators": [
44 {
45 "name": "source",
46 "id": "opid-1",
47 "params": [
48 {
49 "key": "data_path",
50 "value": "bos://databuilder-workflow-dev/jd"
51 },
52 {
53 "key": "data_format",
54 "value": "CSV"
55 }
56 ],
57 "metaData": {
58 "catalogName": "system",
59 "schemaName": "default",
60 "operatorName": "databuilder_location_loader",
61 "version": "v1",
62 "operatorIdentifier": "system_default_databuilder_location_loader_v1"
63 }
64 },
65 {
66 "name": "videoScanner",
67 "id": "opid-2",
68 "params": [
69 {
70 "key": "video_bos_path_col",
71 "value": "video_bos_path"
72 },
73 {
74 "key": "bos_ak_col",
75 "value": "bos_ak"
76 },
77 {
78 "key": "bos_sk_col",
79 "value": "bos_sk"
80 },
81 {
82 "key": "bos_endpoint_col",
83 "value": "bos_endpoint"
84 },
85 {
86 "key": "download_path_col",
87 "value": "download_path"
88 }
89 ],
90 "metaData": {
91 "catalogName": "system",
92 "schemaName": "default",
93 "operatorName": "video_scanner",
94 "version": "v1",
95 "operatorIdentifier": "system_default_video_scanner_v1"
96 },
97 "dependsOn": [
98 "opid-1"
99 ]
100 },
101 {
102 "name": "videoInfoExtractor",
103 "id": "opid-3",
104 "params": [
105 {
106 "key": "bos_ak",
107 "value": "ak"
108 },
109 {
110 "key": "bos_sk",
111 "value": "sk"
112 },
113 {
114 "key": "bos_endpoint",
115 "value": "http://s3.bd.bcebos.com"
116 },
117 {
118 "key": "bos_token",
119 "value": ""
120 },
121 {
122 "key": "download_path",
123 "value": "task_download"
124 }
125 ],
126 "metaData": {
127 "catalogName": "system",
128 "schemaName": "default",
129 "operatorName": "video_info_extractor",
130 "version": "v1",
131 "operatorIdentifier": "system_default_video_info_extractor_v1"
132 },
133 "dependsOn": [
134 "opid-2"
135 ]
136 },
137 {
138 "name": "videoInfoFilter",
139 "id": "opid-4",
140 "params": [
141 {
142 "key": "filter_col",
143 "value": "num_frames"
144 },
145 {
146 "key": "filter_value",
147 "value": "100"
148 },
149 {
150 "key": "filter_operator",
151 "value": "<"
152 }
153 ],
154 "metaData": {
155 "catalogName": "system",
156 "schemaName": "default",
157 "operatorName": "column_filter",
158 "version": "v1",
159 "operatorIdentifier": "system_default_column_filter_v1"
160 },
161 "dependsOn": [
162 "opid-3"
163 ]
164 },
165 {
166 "name": "video_scene_detector",
167 "id": "opid-5",
168 "params": [
169 {
170 "key": "bos_ak",
171 "value": "ak"
172 },
173 {
174 "key": "bos_sk",
175 "value": "sk"
176 },
177 {
178 "key": "bos_token",
179 "value": ""
180 },
181 {
182 "key": "bos_endpoint",
183 "value": "http://s3.bd.bcebos.com"
184 },
185 {
186 "key": "download_path",
187 "value": "task_download"
188 }
189 ],
190 "metaData": {
191 "catalogName": "system",
192 "schemaName": "default",
193 "operatorName": "video_scene_detector",
194 "version": "v1",
195 "operatorIdentifier": "system_default_video_scene_detector_v1"
196 },
197 "dependsOn": [
198 "opid-4"
199 ]
200 },
201 {
202 "name": "videoSceneCutTransformer",
203 "id": "opid-6",
204 "params": [
205 {
206 "key": "bos_ak",
207 "value": "ak"
208 },
209 {
210 "key": "bos_sk",
211 "value": "sk"
212 },
213 {
214 "key": "bos_endpoint",
215 "value": "http://s3.bd.bcebos.com"
216 },
217 {
218 "key": "bos_token",
219 "value": ""
220 },
221 {
222 "key": "download_path",
223 "value": "task_download"
224 },
225 {
226 "key": "cut_video_save_path",
227 "value": "./cut_videos"
228 },
229 {
230 "key": "bos_cut_video_bucket_name",
231 "value": "databuilder-dev"
232 },
233 {
234 "key": "bos_cut_video_key",
235 "value": "output/cut_videos"
236 }
237 ],
238 "metaData": {
239 "catalogName": "system",
240 "schemaName": "default",
241 "operatorName": "video_scene_cutter",
242 "version": "v1",
243 "operatorIdentifier": "system_default_video_scene_cutter_v1"
244 },
245 "dependsOn": [
246 "opid-5"
247 ]
248 },
249 {
250 "name": "aesthetic_evaluation",
251 "id": "opid-7",
252 "params": [
253 {
254 "key": "aes_frames",
255 "value": "3"
256 },
257 {
258 "key": "video_bos_path",
259 "value": "bos://xxx"
260 },
261 {
262 "key": "bos_ak",
263 "value": "ak"
264 },
265 {
266 "key": "bos_sk",
267 "value": "sk"
268 },
269 {
270 "key": "bos_token",
271 "value": ""
272 },
273 {
274 "key": "bos_endpoint",
275 "value": "http://s3.bd.bcebos.com"
276 },
277 {
278 "key": "download_path",
279 "value": "task_download"
280 }
281 ],
282 "metaData": {
283 "catalogName": "system",
284 "schemaName": "default",
285 "operatorName": "aesthetic_evaluation",
286 "version": "v1",
287 "operatorIdentifier": "system_default_aesthetic_evaluation_v1"
288 },
289 "dependsOn": [
290 "opid-6"
291 ]
292 },
293 {
294 "name": "aesthetic_evaluation_filter",
295 "id": "opid-8",
296 "params": [
297 {
298 "key": "filter_col",
299 "value": "aes"
300 },
301 {
302 "key": "filter_value",
303 "value": "0"
304 },
305 {
306 "key": "filter_operator",
307 "value": "<"
308 }
309 ],
310 "metaData": {
311 "catalogName": "system",
312 "schemaName": "default",
313 "operatorName": "column_filter",
314 "version": "v1",
315 "operatorIdentifier": "system_default_column_filter_v1"
316 },
317 "dependsOn": [
318 "opid-7"
319 ]
320 },
321 {
322 "name": "optical_flow_evaluation",
323 "id": "opid-9",
324 "params": [
325 {
326 "key": "video_bos_path",
327 "value": "bos://xxx"
328 },
329 {
330 "key": "bos_ak",
331 "value": "ak"
332 },
333 {
334 "key": "bos_sk",
335 "value": "sk"
336 },
337 {
338 "key": "bos_token",
339 "value": ""
340 },
341 {
342 "key": "bos_endpoint",
343 "value": "http://s3.bd.bcebos.com"
344 },
345 {
346 "key": "download_path",
347 "value": "task_download"
348 }
349 ],
350 "metaData": {
351 "catalogName": "system",
352 "schemaName": "default",
353 "operatorName": "optical_flow_evaluation",
354 "version": "v1",
355 "operatorIdentifier": "system_default_optical_flow_evaluation_v1"
356 },
357 "dependsOn": [
358 "opid-8"
359 ]
360 },
361 {
362 "name": "optical_flow_filter",
363 "id": "opid-10",
364 "params": [
365 {
366 "key": "filter_col",
367 "value": "flow"
368 },
369 {
370 "key": "filter_value",
371 "value": "0.5"
372 },
373 {
374 "key": "filter_operator",
375 "value": "<"
376 }
377 ],
378 "metaData": {
379 "catalogName": "system",
380 "schemaName": "default",
381 "operatorName": "column_filter",
382 "version": "v1",
383 "operatorIdentifier": "system_default_column_filter_v1"
384 },
385 "dependsOn": [
386 "opid-9"
387 ]
388 },
389 {
390 "name": "ocr_evaluation",
391 "id": "opid-11",
392 "params": [
393 {
394 "key": "video_bos_path",
395 "value": "bos://xxx"
396 },
397 {
398 "key": "bos_ak",
399 "value": "ak"
400 },
401 {
402 "key": "bos_sk",
403 "value": "sk"
404 },
405 {
406 "key": "bos_token",
407 "value": ""
408 },
409 {
410 "key": "bos_endpoint",
411 "value": "http://s3.bd.bcebos.com"
412 },
413 {
414 "key": "download_path",
415 "value": "task_download"
416 }
417 ],
418 "metaData": {
419 "catalogName": "system",
420 "schemaName": "default",
421 "operatorName": "ocr_evaluation",
422 "version": "v1",
423 "operatorIdentifier": "system_default_ocr_evaluation_v1"
424 },
425 "dependsOn": [
426 "opid-10"
427 ]
428 },
429 {
430 "name": "ocr_evl_filter",
431 "id": "opid-12",
432 "params": [
433 {
434 "key": "filter_col",
435 "value": "ocr"
436 },
437 {
438 "key": "filter_value",
439 "value": "10"
440 },
441 {
442 "key": "filter_operator",
443 "value": ">"
444 }
445 ],
446 "metaData": {
447 "catalogName": "system",
448 "schemaName": "default",
449 "operatorName": "column_filter",
450 "version": "v1",
451 "operatorIdentifier": "system_default_column_filter_v1"
452 },
453 "dependsOn": [
454 "opid-11"
455 ]
456 },
457 {
458 "name": "pllava_caption",
459 "id": "opid-13",
460 "params": [
461 {
462 "key": "pooling_shape",
463 "value": "4-12-12"
464 },
465 {
466 "key": "num_frames",
467 "value": "4"
468 },
469 {
470 "key": "use_lora",
471 "value": "True"
472 },
473 {
474 "key": "lora_alpha",
475 "value": "4"
476 },
477 {
478 "key": "conv_mode",
479 "value": "eval_mvbench"
480 },
481 {
482 "key": "result_key",
483 "value": "pllavacap"
484 },
485 {
486 "key": "video_bos_path",
487 "value": "bos://xxx"
488 },
489 {
490 "key": "bos_ak",
491 "value": "ak"
492 },
493 {
494 "key": "bos_sk",
495 "value": "sk"
496 },
497 {
498 "key": "bos_token",
499 "value": ""
500 },
501 {
502 "key": "bos_endpoint",
503 "value": "http://s3.bd.bcebos.com"
504 },
505 {
506 "key": "download_path",
507 "value": "task_download"
508 }
509 ],
510 "metaData": {
511 "catalogName": "system",
512 "schemaName": "default",
513 "operatorName": "pllava_caption",
514 "version": "v1",
515 "operatorIdentifier": "system_default_pllava_caption_v1"
516 },
517 "dependsOn": [
518 "opid-12"
519 ]
520 },
521 {
522 "name": "match_score",
523 "id": "opid-14",
524 "params": [
525 {
526 "key": "match_key",
527 "value": "pllavacap"
528 },
529 {
530 "key": "video_bos_path",
531 "value": "bos://xxx"
532 },
533 {
534 "key": "bos_ak",
535 "value": "ak"
536 },
537 {
538 "key": "bos_sk",
539 "value": "sk"
540 },
541 {
542 "key": "bos_token",
543 "value": ""
544 },
545 {
546 "key": "bos_endpoint",
547 "value": "http://s3.bd.bcebos.com"
548 },
549 {
550 "key": "download_path",
551 "value": "task_download"
552 }
553 ],
554 "metaData": {
555 "catalogName": "system",
556 "schemaName": "default",
557 "operatorName": "matching_score",
558 "version": "v1",
559 "operatorIdentifier": "system_default_matching_score_v1"
560 },
561 "dependsOn": [
562 "opid-13"
563 ]
564 },
565 {
566 "name": "match_filter",
567 "id": "opid-15",
568 "params": [
569 {
570 "key": "filter_col",
571 "value": "match"
572 },
573 {
574 "key": "filter_value",
575 "value": "5"
576 },
577 {
578 "key": "filter_operator",
579 "value": "<"
580 }
581 ],
582 "metaData": {
583 "catalogName": "system",
584 "schemaName": "default",
585 "operatorName": "column_filter",
586 "version": "v1",
587 "operatorIdentifier": "system_default_column_filter_v1"
588 },
589 "dependsOn": [
590 "opid-14"
591 ]
592 },
593 {
594 "name": "sink",
595 "id": "opid-16",
596 "params": [
597 {
598 "key": "export_path",
599 "value": "bos://databuilder-workflow-dev/jd_result "
600 },
601 {
602 "key": "data_format",
603 "value": "CSV"
604 }
605 ],
606 "metaData": {
607 "catalogName": "system",
608 "schemaName": "default",
609 "operatorName": "exporter",
610 "version": "v1",
611 "operatorIdentifier": "system_default_exporter_v1"
612 },
613 "dependsOn": [
614 "opid-15"
615 ]
616 }
617 ]
618 },
619 "valid": true,
620 "taskProvided": false
621 }
622 ]
623 }
624 ]
625 }
626}