更新时间:2024-05-08 GMT+08:00

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

功能介绍

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

调用方法

请参见如何调用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

错误码

请参见错误码