更新时间:2024-09-04 GMT+08:00
分享

获取任务构建记录列表

功能介绍

获取任务构建记录列表

调用方法

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

错误码

请参见错误码

相关文档