文档首页/ 编译构建 CodeArts Build/ API参考/ 任务相关API接口/ 获取指定工程的构建记录列表
更新时间:2024-11-08 GMT+08:00
分享

获取指定工程的构建记录列表

功能介绍

获取指定工程的构建记录列表

调用方法

请参见如何调用API

URI

GET /v1/record/{build_project_id}/records

表1 路径参数

参数

是否必选

参数类型

描述

build_project_id

String

构建工程项目ID,36位数字、小写字母组合。

表2 Query参数

参数

是否必选

参数类型

描述

page

Integer

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

limit

Integer

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

triggers

Array of strings

需要搜索的触发类型列表

branches

Array of strings

需要搜索的分支列表

tags

Array of strings

需要搜索的标签列表

from_date

String

查询起止时间,格式:yyyy-MM-dd HH:mm:ss

to_date

String

查询结束时间,格式:yyyy-MM-dd HH:mm:ss

请求参数

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

result

result object

项目列表

error

String

返回错误信息

status

String

返回状态信息

表4 result

参数

参数类型

描述

pagination

pagination object

分页信息

data

Array of BuildRecord objects

工程构建记录列表

表5 pagination

参数

参数类型

描述

page

String

分页页数

limit

String

每页数量

total

String

总数

表6 BuildRecord

参数

参数类型

描述

id

String

唯一标识

status

String

状态

status_code

String

状态码

create_time

String

创建时间

schedule_time

String

等待时间

queued_time

String

排队时间

start_time

String

开始时间

finish_time

String

完成时间

duration

Integer

持续时间

build_duration

Integer

构建时间

pending_duration

Integer

等待时间

project_id

String

工程ID

display_name

String

子任务名称

trigger_name

String

触发者名称

group_name

String

分组名

execution_id

String

八爪鱼任务ID

parameters

Array of parameters objects

构建执行参数列表

repository

String

仓库地址

branch

String

分支名

revision

String

commitId

build_yml_path

String

yaml路径

build_yml_url

String

yaml地址

daily_build_number

String

构建每日编号

build_record_type

build_record_type object

构建记录类型

trigger_type

String

触发类型

scm_type

String

代码源类型

scm_web_url

String

代码源地址

user_id

String

用户id

build_no

String

构建编码

daily_build_no

String

构建每日编号

dev_cloud_build_type

String

构建类型

表7 parameters

参数

参数类型

描述

name

String

参数名

secret

String

是否为私密参数

value

String

参数值

type

String

类型

表8 build_record_type

参数

参数类型

描述

rerun

Boolean

是否rerun

trigger_type

String

触发类型

record_type

String

记录类型

is_rerun

Boolean

是否返回

状态码: 400

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码: 401

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码: 403

表11 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码: 404

表12 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码: 500

表13 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

GET https://{endpoint}/v1/record/a3270d84-ddc7-4288-b985-f801871b260d/records

响应示例

状态码: 200

OK

{
  "result" : {
    "pagination" : {
      "page" : 0,
      "limit" : 10,
      "total" : -1
    },
    "data" : [ {
      "id" : "534488f1-8f08-4e2b-9bbb-9f3f20e0708e",
      "status" : "ABORTED",
      "duration" : 0,
      "parameters" : [ {
        "name" : "codeBranch",
        "secret" : false,
        "value" : "master"
      } ],
      "repository" : "https://codehub.devcloud.cn-north-7.ulanqab.huawei.com:6823252f543d4915b49892a5fd9f0ec3/APITestCreateMaven02.git",
      "branch" : "master",
      "revision" : "",
      "status_code" : 8,
      "create_time" : "2024-06-26T08:25:09.000+00:00",
      "schedule_time" : "2024-06-26T08:25:11.000+00:00",
      "queued_time" : "2024-06-26T08:25:09.000+00:00",
      "start_time" : "2024-06-26T08:25:09.000+00:00",
      "finish_time" : "2024-06-26T08:25:26.000+00:00",
      "build_duration" : 0,
      "pending_duration" : 0,
      "project_id" : "a3270d84-ddc7-4288-b985-f801871b260d",
      "display_name" : "APITest-getInfo-yCAdLM",
      "trigger_name" : "testUser",
      "group_name" : "",
      "execution_id" : "j_VCcmey1D",
      "build_yml_path" : ".cloudbuild/build.yml",
      "build_yml_url" : "https://codehub.devcloud.cn-north-7.ulanqab.huawei.com:6823252f543d4915b49892a5fd9f0ec3/APITestCreateMaven02/blob/master/.cloudbuild/build.yml",
      "daily_build_number" : "20240626.2",
      "build_record_type" : {
        "trigger_type" : "MANUAL",
        "record_type" : "JOB"
      },
      "trigger_type" : "MANUAL",
      "scm_type" : "codehub",
      "scm_web_url" : "https://devcloud.cn-north-7.ulanqab.huawei.com/codehub/2111857371/home",
      "user_id" : "ae22fd035f354cfa8d82a3f1c8940446",
      "build_no" : "2",
      "daily_build_no" : "20240626.2",
      "dev_cloud_build_type" : "branch"
    } ]
  },
  "error" : null,
  "status" : "success"
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档