文档首页/ 流水线 CodeArts Pipeline/ API参考/ API/ 流水线管理（旧版，待下线）/ 获取项目下流水线执行状况
更新时间：2024-11-29 GMT+08:00
在线调试
CLI示例
查看PDF
分享

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

功能介绍

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

调用方法

请参见如何调用API。

URI

GET /v3/pipelines/build-result

表1 Query参数

参数

是否必选

参数类型

描述

project_id

是

String

项目id

start_date

是

String

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

end_date

是

String

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

offset

是

Integer

偏移量,表示从此偏移量开始查询,offset大于等于0

limit

是

Integer

每次查询的条目数量

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

否

String

用户Token。

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

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

offset

Integer

偏移量,表示从此偏移量开始查询,offset大于等于0

limit

Integer

每次查询的条目数量

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

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

OK

{
  "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

错误码

请参见错误码。

父主题： 流水线管理（旧版，待下线）

相关文档