文档首页/ 流水线 CodeArts Pipeline/ API参考/ API/ 流水线管理(旧版,待下线)/ 获取项目下流水线执行状况 - ListPipelineBuildResult
更新时间:2026-09-18 GMT+08:00

获取项目下流水线执行状况 - ListPipelineBuildResult

功能介绍

获取项目下流水线执行状况

调用方法

请参见如何调用API。

URI

GET /v3/pipelines/build-result

表1 Query参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID,获取方式请参见获取项目ID。

约束限制:

不涉及。

取值范围:

32位字符,由数字和字母组成。

默认取值:

不涉及。

start_date

是

String

参数解释:

起始日期。

约束限制:

起始日期和结束日期间隔不超过一个月,查询包含起始日期。

取值范围:

不涉及。

默认取值:

不涉及。

end_date

是

String

参数解释:

起始日期。

约束限制:

起始日期和结束日期间隔不超过一个月,查询包含起始日期。

取值范围:

不涉及。

默认取值:

不涉及。

offset

是

Integer

参数解释:

偏移量,表示从此偏移量开始查询。

约束限制:

不涉及。

取值范围:

大于等于0。

默认取值:

不涉及。

limit

是

Integer

参数解释:

每次查询的条目数量。

约束限制:

不涉及。

取值范围:

大于等于0。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

否

String

参数解释:

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

offset

Integer

参数解释:

偏移量,表示从此偏移量开始查询。

取值范围:

offset大于等于0。

limit

Integer

参数解释:

每次查询的条目数量。

取值范围:

大于等于0。

total

Integer

参数解释:

总条目数量。

取值范围:

不涉及。

build_results

Array of PipelineBuildResult objects

参数解释:

执行状况数据列表。

取值范围:

不涉及。

表4 PipelineBuildResult

参数

参数类型

描述

build_id

String

参数解释:

流水线执行ID。

取值范围:

不涉及。

elapse_time

String

参数解释:

运行耗时,单位为毫秒。

取值范围:

不涉及。

end_time

String

参数解释:

执行结束时间。

取值范围:

不涉及。

outcome

String

参数解释:

运行结果。

取值范围:

  • success:成功。

  • error:失败。

  • aborted:终止。

pipeline_id

String

参数解释:

流水线id。

取值范围:

32位字符,由数字和字母组成。

pipeline_name

String

参数解释:

流水线名称。

取值范围:

不涉及。

start_time

String

参数解释:

执行开始时间。

取值范围:

不涉及。

status

String

参数解释:

运行状态。

取值范围:

  • waiting:等待中。

  • running:运行中。

  • verifying:待审核。

  • suspending:挂起。

  • completed:执行完成。

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释:

错误信息。

取值范围:

不涉及。

error_code

String

参数解释:

错误码。

取值范围:

不涉及。

请求示例

GET https://{endpoint}/v3/pipelines/build-result?project_id=8025ba36a87a4885af496708c2961817&start_date=2020-07-01&end_date=2020-07-31&offset=0&limit=10

响应示例

状态码:200

{
  "offset" : 0,
  "limit" : 10,
  "total" : 29,
  "build_results" : [ {
    "status" : "completed",
    "outcome" : "success",
    "pipeline_id" : "fbe06e5655764f049f4d988bd2941279",
    "pipeline_name" : "接口测试流水线_YN96I241",
    "build_id" : "12",
    "start_time" : "2021-08-10 00:00:01",
    "end_time" : "2021-08-10 00:00:02",
    "elapse_time" : "917"
  } ]
}

状态码

状态码

描述

200

OK

400

Bad request

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码。