# 查询流水线执行记录 - ListPipelineBuildRecords #### 功能介绍 查询流水线执行记录 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-pipeline/pipeline_03_0006.html)。 #### URI GET /v3/pipelines/{pipeline_id}/build-records 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | pipeline_id | 是 | String | **参数解释**： 流水线ID，可以通过[查询流水线列表](https://support.huaweicloud.com/api-pipeline/ListPipelines.html)接口，其中pipelines.pipelineId即为流水线ID。 **约束限制**： 不涉及。 **取值范围**： 32位字符，仅由数字和字母组成。 **默认取值**： 不涉及。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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接口](https://support.huaweicloud.com/api-iam/iam_30_0003.html)获取（响应消息头中X-Subject-Token的值）。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | X-Language | 否 | String | **参数解释**： 语言类型。 **约束限制**： 不涉及。 **取值范围**： - zh-cn：中文。 - en-us：英文。 **默认取值**： en-us。 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Integer | **参数解释**： 总条目数量。 **取值范围**： 不涉及。 | | records | Array of [PipelineBuildRecordInfo] objects | **参数解释**： 流水线执行记录相关信息。 **取值范围**： 不涉及。 | 表5PipelineBuildRecordInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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** 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 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-pipeline/ErrorCode.html)。