文档首页> 编译构建 CloudBuild> API参考> 任务相关接口> 根据开始时间和结束时间查看构建任务的构建历史列表
更新时间:2022-04-15 GMT+08:00
分享

根据开始时间和结束时间查看构建任务的构建历史列表

功能介绍

根据开始时间和结束时间查看构建任务的构建历史列表

调试

您可以在API Explorer中调试该接口。

URI

GET /v3/jobs/{job_id}/period-history

表1 路径参数

参数

是否必选

参数类型

描述

job_id

String

构建的任务ID 获取项目下构建任务列表; 编辑构建任务时,浏览器URL末尾的32位数字、字母组合的字符串。

表2 Query参数

参数

是否必选

参数类型

描述

offset

Integer

分页页码, 表示从此页开始查询, offset大于等于0

limit

Integer

每页显示的条目数量,limit小于等于100

start_time

String

区间开始时间,格式yyyy-MM-dd。 开始时间和结束时间间隔不能超过30天

end_time

String

区间结束时间,格式yyyy-MM-dd。 开始时间和结束时间间隔不能超过30天

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。 通过调用IAM服务 获取IAM用户Token接口获取 (响应消息头中X-Subject-Token的值)。 不支持租户全局token,请使用scope为project的region级token。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

total

Integer

记录总数

history_records

Array of history_records objects

构建历史列表

表5 history_records

参数

参数类型

描述

record_id

String

构建记录id--唯一key

job_id

String

任务id

build_number

Integer

构建编号

start_time

String

构建开始时间

end_time

String

构建结束时间

result

String

构建结果

branch

String

代码分支

commit_id

String

代码提交的commit id

commit_message

String

代码提交时用户输入的提交信息,只有使用codehub仓库时有值

executor

String

执行构建任务的用户的用户名

trigger_type

String

触发方式,可选值:手工触发,定时触发,代码更新触发,流水线触发

状态码: 400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码: 401

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码: 403

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码: 404

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码: 500

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

GET https://{endpoint}/v3/jobs/{job_id}/period-history?start_time=2021-01-04&end_time=2021-01-14&offset=0&limit=10

响应示例

状态码: 200

OK

{
  "total" : 1,
  "history_records" : {
    "record_id" : "20201230.1",
    "job_id" : "f9d6c8466d614a9788e9a0acf6c15f46",
    "build_number" : 55,
    "start_time" : "2020-12-30T17:33:11+08:00",
    "end_time" : "2020-12-30T17:33:27+08:00",
    "result" : "FAILURE",
    "branch" : "master",
    "commit_id" : "2f37dd494927d2c6259417c58e5faeb72bfe7150",
    "commit_message" : "test",
    "executor" : "test",
    "trigger_type" : "手工触发"
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

错误码

请参见错误码

分享:

    相关文档

    相关产品

close