文档首页/ 编译构建 CodeArts Build/ API参考/ 任务相关API接口/ 获取指定工程的简要构建信息
更新时间：2024-11-08 GMT+08:00
在线调试
CLI示例
查看PDF
分享

获取指定工程的简要构建信息

功能介绍

获取指定工程的简要构建信息

调用方法

请参见如何调用API。

URI

POST /v1/record/brief

表1 Query参数

参数

是否必选

参数类型

描述

limit

否

Integer

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

默认取值：

10

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

[数组元素]

是

Array of strings

项目ID

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

result

Array of result objects

结果列表

error

Object

错误

status

String

状态信息
表4 result

参数

参数类型

描述

project_id

String

需要查询的项目ID

brief_build_record_dtos

Array of BriefRecordItems objects

简要构建信息列表
表5 BriefRecordItems

参数

参数类型

描述

id

String

构建任务的ID

status

String

状态

duration

Integer

构建时长

create_time

String

创建时间

schedule_time

String

构建下发时间

queued_time

String

构建排队耗时

start_time

String

开始时间

finish_time

String

结束时间

build_duration

Integer

子任务构建耗时

pending_duration

Integer

等待时间

project_id

String

所属的项目ID

build_no

Integer

构建任务的构建编号，从1开始，每次构建递增1

branch

String

代码分支

revision

String

commitId

trigger_name

String

触发者名称

daily_build_number

String

构建编号，每日从1开始

状态码： 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

错误描述

请求示例

POST https://{endpoint}/v1/record/brief?limit=10

响应示例

状态码： 200

OK

{
  "result" : [ {
    "project_id" : "string",
    "brief_build_record_dtos" : [ {
      "id" : "bf44443d-190b-4f21-8f6c-08cf511e8415",
      "status" : "SCHEDULE_FAILURE",
      "duration" : 0,
      "create_time" : "2024-08-31 10:58:02",
      "schedule_time" : "2024-08-12T02:31:01+0800",
      "queued_time" : "2024-08-12T02:31:01+0800",
      "start_time" : "2024-08-12T02:31:01+0800",
      "finish_time" : "2024-08-12T02:31:01+0800",
      "build_duration" : 0,
      "pending_duration" : 0,
      "project_id" : "string",
      "build_no" : 227,
      "branch" : "master",
      "revision" : "e980b883c1590363818225ec649d7cf161f0d49c",
      "trigger_name" : "devcloud_codeci_z00485259_03",
      "daily_build_number" : "string"
    } ]
  } ],
  "error" : { },
  "status" : "success"
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

父主题： 任务相关API接口

相关文档