查询工作流运行列表
更新时间：2026-09-04
描述
查询指定工作流模版（Pipeline）下的运行实例（PipelineRun）列表，支持状态、时间范围、分页等过滤条件。
请求结构
Bash
1GET /?action=DescribePipelineRuns&pipelineId=xxxx
2Host: aihc.bj.baidubce.com
3Authorization: authorization string
4Version: v2请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 说明 |
|---|---|---|---|---|
| pipelineId | String | 是 | Query 参数 | Pipeline ID |
| status | String | 否 | Query 参数 | 运行状态过滤，如 running、succeeded、failed |
| startTime | String | 否 | Query 参数 | 运行开始时间下限（ISO 8601 格式） |
| endTime | String | 否 | Query 参数 | 运行开始时间上限（ISO 8601 格式） |
| pageNumber | Integer | 否 | Query 参数 | 页码，从 1 开始，默认 1 |
| pageSize | Integer | 否 | Query 参数 | 每页条数，默认 10 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| requestId | String | 请求 ID |
| items | Array | 运行实例列表，见下表 |
| total | Integer | 总条数 |
| pageNumber | Integer | 当前页码 |
| pageSize | Integer | 每页条数 |
items 数组元素字段说明：
| 字段名 | 类型 | 说明 |
|---|---|---|
| runId | String | 运行 ID |
| pipelineId | String | 所属 Pipeline ID |
| status | String | 运行状态 |
| startedAt | String | 开始时间 |
| finishedAt | String | 完成时间 |
| createTime | String | 创建时间 |
请求示例
JSON
1GET /?action=DescribePipelineRuns&pipelineId=pipe-4zu7gy&pageNumber=1&pageSize=10返回示例
JSON
1{
2 "items": [
3 {
4 "argoPhase": "succeeded",
5 "argoWorkflowName": "syf-test-openapi-pipeline-0826-ncxv7",
6 "argoWorkflowNamespace": "argo",
7 "argoWorkflowUid": "17f4aef6-975d-4f85-88d5-74b8c4e90f9b",
8 "createdAt": "2026-08-27T02:24:56Z",
9 "failureEvents": "",
10 "finishedAt": "2026-08-27T02:26:00Z",
11 "id": 8270,
12 "inputParameters": "{}",
13 "manifest": "YXBpVmVyc2lvbjogIiIKdmVyc2lvbjogdjEKa2luZDogUGlwZWxpbmVUZW1wbGF0ZQptZXRhZGF0YToge30KaW5wdXRzOgogICAgLSBuYW1lOiBDY2VDbHVzdGVySUQKICAgICAgdmFsdWU6IGNjZS1na2xoam5xOAogICAgLSBuYW1lOiBSZXNvdXJjZVBvb2xJRAogICAgICB2YWx1ZTogYWloYy1nOXFtMGF2Nzl6MDYKICAgIC0gbmFtZTogQWNjb3VudElECiAgICAgIHZhbHVlOiAwZTA2OGNiOTQ1Yzc0YmM3OTBiODNkMDVlNmQ4YjdlOQp0YXNrVGVtcGxhdGVzOgogICAgLSBuYW1lOiBjdXN0b20tdGFzay10ZW1wbGF0ZQogICAgICB0eXBlOiBDdXN0b21UYXNrCiAgICAgIGlucHV0czoKICAgICAgICAtIG5hbWU6IHF1ZXVlX2lkCiAgICAgICAgICB0eXBlOiBzdHJpbmcKICAgICAgICAgIGhpbnQ6IOmYn+WIl0lECiAgICAgICAgLSBuYW1lOiBjb21tYW5kCiAgICAgICAgICB0eXBlOiBzdHJpbmcKICAgICAgICAgIGhpbnQ6IOaJp+ihjOWRveS7pAogICAgICAgIC0gbmFtZTogaW1hZ2VfdXJsCiAgICAgICAgICB0eXBlOiBzdHJpbmcKICAgICAgICAgIGhpbnQ6IOmVnOWDj+WcsOWdgAogICAgICAgIC0gbmFtZTogY3B1CiAgICAgICAgICB0eXBlOiBpbnQKICAgICAgICAgIGhpbnQ6IENQVeeUs+ivt+mFjeminSjmoLjvvIkKICAgICAgICAgIGRlZmF1bHRWYWx1ZTogMQogICAgICAgIC0gbmFtZTogbWVtb3J5CiAgICAgICAgICB0eXBlOiBpbnQKICAgICAgICAgIGhpbnQ6IOWGheWtmOeUs+ivt+mFjeminShHQikKICAgICAgICAgIGRlZmF1bHRWYWx1ZTogMgogICAgICBzcGVjOgogICAgICAgIGNvbW1hbmQ6ICd7e2lucHV0cy5wYXJhbWV0ZXJzLmNvbW1hbmR9fScKICAgICAgICBkYXRhc291cmNlczogW10KICAgICAgICBqb2JTcGVjOgogICAgICAgICAgICBpbWFnZTogJ3t7aW5wdXRzLnBhcmFtZXRlcnMuaW1hZ2VfdXJsfX0nCiAgICAgICAgICAgIHJlcGxpY2FzOiAxCiAgICAgICAgICAgIHJlc291cmNlczoKICAgICAgICAgICAgICAgIC0gbmFtZTogY3B1CiAgICAgICAgICAgICAgICAgIHF1YW50aXR5OiAne3tpbnB1dHMucGFyYW1ldGVycy5jcHV9fScKICAgICAgICAgICAgICAgIC0gbmFtZTogbWVtb3J5CiAgICAgICAgICAgICAgICAgIHF1YW50aXR5OiAne3tpbnB1dHMucGFyYW1ldGVycy5tZW1vcnl9fScKICAgICAgICBqb2JUeXBlOiBQeVRvcmNoSm9iCiAgICAgICAgcXVldWU6ICd7e2lucHV0cy5wYXJhbWV0ZXJzLnF1ZXVlX2lkfX0nCnRhc2tzOgogICAgLSBuYW1lOiBmaXJzdF93b3JrZmxvd190YXNrX2RlbW8KICAgICAgdGFza1RlbXBsYXRlTmFtZTogY3VzdG9tLXRhc2stdGVtcGxhdGUKICAgICAgaW5wdXRzOgogICAgICAgIC0gbmFtZTogcXVldWVfaWQKICAgICAgICAgIHZhbHVlOiBhaWhjcS1hN2dmbm45OWxwbGcKICAgICAgICAtIG5hbWU6IGNvbW1hbmQKICAgICAgICAgIHZhbHVlOiBlY2hvICJUaGlzIGlzIHlvdXIgZmlyc3Qgd29ya2Zsb3cgdGFzay4iCiAgICAgICAgLSBuYW1lOiBpbWFnZV91cmwKICAgICAgICAgIHZhbHVlOiByZWdpc3RyeS5iYWlkdWJjZS5jb20vYWloYy1haWFrL2FpYWstbWVnYXRyb246dWJ1bnR1MjAuMDQtY3UxMS44LXRvcmNoMS4xNC4wLXB5MzhfdjEuMi43LjEyX3JlbGVhc2UKICAgICAgICAtIG5hbWU6IGNwdQogICAgICAgICAgdmFsdWU6IDAuNQogICAgICAgIC0gbmFtZTogbWVtb3J5CiAgICAgICAgICB2YWx1ZTogMQo=",
14 "pipelineId": "pipe-15z9n2",
15 "retryable": false,
16 "runId": "17f4aef6-975d-4f85-88d5-74b8c4e90f9b",
17 "runType": "manual",
18 "startedAt": "2026-08-27T02:24:55Z",
19 "status": "succeeded",
20 "updatedAt": "2026-08-27T02:27:35Z"
21 }
22 ],
23 "pageNumber": 1,
24 "pageSize": 20,
25 "requestId": "bd9e9ecb-4a4b-44b3-892c-529fd87255f0",
26 "total": 1
27}评价此篇文章