更新时间:2025-07-08 GMT+08:00
分享

获取构建任务实例详情

功能介绍

此API用于根据构建任务实例ID获取构建任务实例详情

URI

GET /assembling/v1/builds/{build_id}

参数说明见表1

表1 路径参数

参数

是否必选

参数类型

描述

build_id

String

构建任务实例ID。获取方法,请参考根据构建任务ID获取构建任务实例列表

请求消息

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

消息体的类型(格式),默认取值为“application/json;charset=utf8”。

X-Auth-Token

String

调用接口的认证方式分为Token和AK/SK两种,如果您使用的Token方式,此参数为必填,请填写Token的值。Token获取方式,请参考获取用户Token

响应消息

表3 响应参数

参数

参数类型

描述

build_id

String

构建任务实例id,和入参一致。

job_id

String

任务id,该构建实例所属任务。

job_name

String

任务名称。

enterprise_project_id

String

企业项目标识。

index

String

该构建任务实例索引。

started_at

String

开始时间。

ended_at

String

结束时间。

build_state

String

构建状态,枚举值:Successful、Failed、Building。

repo_type

String

仓库类型,枚举值:GitHub、DevCloud、Gitlab、Gitee。

repo

String

仓库地址。

branch

String

仓库代码分支。

commit_id

String

代码提交对应的commit id。

committer

String

代码提交对应的提交人。

commit_time

String

代码提交时间。

commit_comment

String

代码提交评论。

language

String

语言类型,例如java,nodejs。

type

String

类型,系统创建的还是用户创建,值有user、system。

creator

String

创建人。

请求示例

响应示例

{
    "build_id": "sxxx",
    "job_id": "xxx",
    "job_name": "test",
    "enterprise_project_id": "0",
    "index": 2,
    "started_at": "2025-06-24 12:10:30 +0000 UTC",
    "ended_at": "2025-06-24 12:11:22 +0000 UTC",
    "build_state": "Failed",
    "repo_type": "DevCloud",
    "repo": "",
    "branch": "master",
    "commit_id": "xx",
    "committer": "xx",
    "commit_time": "2023-09-20",
    "commit_comment": "xx",
    "language": "java",
    "type": "user",
    "creator": "xx",
}

状态码

状态码

描述

200

操作成功。

400

错误的请求。

错误码

错误码格式为:SVCSTG.CPE.[Error_ID],例如:SVCSTG.CPE.5004401。错误码说明请参考ServiceStage错误码

相关文档