文档首页/ 编译构建 CodeArts Build/ API参考/ 编译构建API/ 构建任务管理/ 根据持续构建名称,获取任务构建状态、百分比、剩余时间
更新时间:2025-08-06 GMT+08:00
分享

根据持续构建名称,获取任务构建状态、百分比、剩余时间

功能介绍

根据持续构建名称,获取任务构建状态、百分比、剩余时间

调用方法

请参见如何调用API

URI

GET /v1/job/{job_id}/{build_no}/build-info

表1 路径参数

参数

是否必选

参数类型

描述

job_id

String

参数解释

填写需要查询构建历史列表的构建任务ID。获取方法:在构建任务详情页,拷贝浏览器URL末尾的32位数字、字母组合的字符串,即为构建任务ID。

约束限制

不涉及。

取值范围

只能是英文字母和数字,长度为32个字符。

默认取值

不涉及。

build_no

Integer

参数解释

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

约束限制

正整数。

取值范围

只能使用数字,大于等于1。

默认取值

1

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

result

Array of result objects

返回结果

error

String

返回错误信息

status

String

返回状态信息

表3 result

参数

参数类型

描述

building

Boolean

是否构建中

build_result

String

构建结果

region

String

region

状态码:400

表4 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码:401

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码:403

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码:404

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码:500

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

GET https://{endpoint}/v1/job/{job_id}/{build_no}/build-info

响应示例

状态码:200

OK

{
  "result" : [ {
    "building" : false,
    "build_result" : "FAILURE",
    "region" : "xx-xxxx-xx"
  } ],
  "error" : null,
  "status" : "success"
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档