查询流水线执行记录 - ListPipelineBuildRecords
功能介绍
查询流水线执行记录
调用方法
请参见如何调用API。
URI
GET /v3/pipelines/{pipeline_id}/build-records
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
pipeline_id | 是 | String | 参数解释: 流水线ID,可以通过查询流水线列表接口,其中pipelines.pipelineId即为流水线ID。 约束限制: 不涉及。 取值范围: 32位字符,仅由数字和字母组成。 默认取值: 不涉及。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
start_date | 否 | String | 参数解释: 起始日期。 约束限制: 起始日期和结束日期间隔不超过一个月,查询包含起始日期。 取值范围: 不涉及。 默认取值: 不涉及。 |
end_date | 否 | String | 参数解释: 起始日期。 约束限制: 起始日期和结束日期间隔不超过一个月,查询包含起始日期。 取值范围: 不涉及。 默认取值: 不涉及。 |
offset | 否 | Integer | 参数解释: 偏移量,表示从此偏移量开始查询。 约束限制: 不涉及。 取值范围: offset大于等于0。 默认取值: 不涉及。 |
limit | 否 | Integer | 参数解释: 每次查询的条目数量。 约束限制: 不涉及。 取值范围: 大于等于0。 默认取值: 不涉及。 |
status | 否 | String | 参数解释: 流水线执行状态。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
outcome | 否 | String | 参数解释: 流水线执行结果。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 参数解释: 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
X-Language | 否 | String | 参数解释: 语言类型。 约束限制: 不涉及。 取值范围:
默认取值: en-us。 |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
total | Integer | 参数解释: 总条目数量。 取值范围: 不涉及。 |
records | Array of PipelineBuildRecordInfo objects | 参数解释: 流水线执行记录相关信息。 取值范围: 不涉及。 |
参数 | 参数类型 | 描述 |
|---|---|---|
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
参数 | 参数类型 | 描述 |
|---|---|---|
error_msg | String | 参数解释: 错误信息。 取值范围: 不涉及。 |
error_code | String | 参数解释: 错误码。 取值范围: 不涉及。 |
请求示例
无
响应示例
状态码:200
OK
{
"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 |
错误码
请参见错误码。

