文档首页/ 流水线 CodeArts Pipeline/ API参考/ API/ 流水线管理（旧版，待下线）/ 查询流水线执行记录 - ListPipelineBuildRecords
更新时间：2026-09-18 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询流水线执行记录 - ListPipelineBuildRecords

功能介绍

查询流水线执行记录

调用方法

请参见如何调用API。

URI

GET /v3/pipelines/{pipeline_id}/build-records

表1 路径参数

参数

是否必选

参数类型

描述

pipeline_id

是

String

参数解释：

流水线ID，可以通过查询流水线列表接口，其中pipelines.pipelineId即为流水线ID。

约束限制：

不涉及。

取值范围：

32位字符，仅由数字和字母组成。

默认取值：

不涉及。
表2 Query参数

参数

是否必选

参数类型

描述

start_date

否

String

参数解释：

起始日期。

约束限制：

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

取值范围：

不涉及。

默认取值：

不涉及。

end_date

否

String

参数解释：

起始日期。

约束限制：

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

取值范围：

不涉及。

默认取值：

不涉及。

offset

否

Integer

参数解释：

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

约束限制：

不涉及。

取值范围：

offset大于等于0。

默认取值：

不涉及。

limit

否

Integer

参数解释：

每次查询的条目数量。

约束限制：

不涉及。

取值范围：

大于等于0。

默认取值：

不涉及。

status

否

String

参数解释：

流水线执行状态。

约束限制：

不涉及。

取值范围：

  • waiting：等待中。

  • running：运行中。

  • verifying：待审核。

  • suspending：挂起。

  • completed：执行完成。

默认取值：

不涉及。

outcome

否

String

参数解释：

流水线执行结果。

约束限制：

不涉及。

取值范围：

  • success：成功。

  • error：失败。

  • aborted：终止。

默认取值：

不涉及。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

X-Language

否

String

参数解释：

语言类型。

约束限制：

不涉及。

取值范围：

  • zh-cn：中文。

  • en-us：英文。

默认取值：

en-us。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

total

Integer

参数解释：

总条目数量。

取值范围：

不涉及。

records

Array of PipelineBuildRecordInfo objects

参数解释：

流水线执行记录相关信息。

取值范围：

不涉及。
表5 PipelineBuildRecordInfo

参数

参数类型

描述

pipeline_id

String

参数解释：

流水线id。

取值范围：

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

pipeline_name

String

参数解释：

流水线名字。

取值范围：

不涉及。

build_id

String

参数解释：

执行编号。

取值范围：

不涉及。

start_time

String

参数解释：

开始时间。

取值范围：

不涉及。

end_time

String

参数解释：

结束时间。

取值范围：

不涉及。

elapse_time

String

参数解释：

执行时长。

取值范围：

不涉及。

execute_type

String

参数解释：

任务类型。

取值范围：

不涉及。

executor_id

String

参数解释：

流水线执行人id。

取值范围：

不涉及。

executor_name

String

参数解释：

流水线执行人名字。

取值范围：

不涉及。

status

String

参数解释：

流水线状态。

取值范围：

不涉及。

outcome

String

参数解释：

流水线结果。

取值范围：

不涉及。

状态码：400

表6 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

请求示例

无

响应示例

状态码：200

{
  "total" : 1,
  "records" : [ {
    "pipeline_id" : "pipeline_001",
    "pipeline_name" : "My Pipeline",
    "build_id" : "build_001",
    "start_time" : "2023-09-15 10:00:00",
    "end_time" : "2023-09-15 10:30:00",
    "elapse_time" : "30 minutes",
    "execute_type" : "manual",
    "executor_id" : "executor_001",
    "executor_name" : "Jane Doe",
    "status" : "success",
    "outcome" : "completed"
  } ]
}

状态码

状态码

描述

200

OK

400

Bad request

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码。