文档首页/ 编译构建 CodeArts Build/ API参考/ 任务相关API接口/ 获取任务构建记录列表
更新时间：2024-09-04 GMT+08:00
在线调试
CLI示例
查看PDF
分享

获取任务构建记录列表

功能介绍

获取任务构建记录列表。

调用方法

请参见如何调用API。

URI

GET /v3/jobs/{job_id}/build-info-records

表1 路径参数

参数

是否必选

参数类型

描述

job_id

是

String

参数解释：

填写构建任务ID。获取方法：在构建任务详情页，拷贝浏览器URL末尾的32位数字、字母组合的字符串，即为构建任务ID。

约束限制：

不涉及。

取值范围：

只能是英文字母和数字，长度为32个字符。
表2 Query参数

参数

是否必选

参数类型

描述

start_time

是

String

区间开始时间，格式yyyy-MM-dd HH:mm:ss。

end_time

是

String

区间结束时间，格式yyyy-MM-dd HH:mm:ss。

page_index

否

Integer

分页页码，表示从此页开始查询， page_index大于等于0

默认取值：

0

page_size

否

Integer

每页显示的条目数量，page_size小于等于100

默认取值：

10

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

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

约束限制：

不支持租户全局token，请使用scope为project的region级token。

取值范围：

不涉及。

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

result

result object

结果

error

String

返回错误信息

status

String

返回状态信息
表5 result

参数

参数类型

描述

health_score

String

健康度

page_index

String

分页页数

total_page

String

总条数

total_record

String

总条数

job_build_states

Array of BuildInfoRecord objects

构建历史详情列表
表6 BuildInfoRecord

参数

参数类型

描述

number

String

构建编号

build_time

Integer

执行时间

start_time

Integer

开始时间，时间戳

job_running_status

String

运行状态

state

String

任务状态

user_id

String

IAM用户ID

executor

String

触发构建用户

nickname

String

用户名称

daily_build_number

String

构建编号，每日从1开始

trigger_type

String

触发类型

cost_time

Integer

执行时间

commit_id

String

代码提交的commit id

commit_info

commit_info object

代码提交信息

build_type

String

构建编号，每日从1开始

code_branch

String

代码仓分支

scm_type

String

代码源类型

scm_web_url

String

代码源地址

commit_detail_url

String

代码提交记录信息地址（代码源为Repo)
表7 commit_info

参数

参数类型

描述

commit_id

String

代码提交的commit id

created_at

String

提交时间

状态码： 400

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码： 401

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码： 403

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码： 404

表11 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码： 500

表12 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

POST https://{endpoint}/v3/jobs/48c66c6002964721be537cdc6ce0297b/33/real-time-log

响应示例

状态码： 200

OK

{
  "result" : {
    "health_score" : "0",
    "page_index" : "0",
    "total_page" : "44",
    "total_record" : "44",
    "job_build_states" : [ {
      "number" : 44,
      "build_time" : 3525000,
      "start_time" : 1703554641000,
      "job_running_status" : "Finished",
      "state" : "SUCCESS",
      "user_id" : "ae22fd035f354cfa8d82a3f1c8940446",
      "executor" : "test",
      "nickname" : "021",
      "daily_build_number" : "20231226.1",
      "trigger_type" : "定时触发",
      "commit_id" : "ffe2ee8b44a0b2683df86b44f8ec27d71baeae86",
      "cost_time" : 3525000,
      "commit_info" : {
        "commit_id" : "ffe2ee8b44a0b2683df86b44f8ec27d71baeae86",
        "created_at" : "2023-11-21T01:48:21.000+00:00"
      },
      "build_type" : "branch",
      "code_branch" : "master",
      "scm_type" : "codehub",
      "scm_web_url" : "https://test.huawei.com/codehub/2111750206/home",
      "commit_detail_url" : "https://test.huawei.com/codehub/2111750206/ffe2ee8b44a0b2683df86b44f8ec27d71baeae86/commitdetail"
    } ]
  },
  "error" : null,
  "status" : "success"
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

父主题： 任务相关API接口

相关文档