启动构建任务
功能介绍
此API用于根据构建任务ID启动构建任务。
URI
POST /assembling/v1/jobs/{job_id}/builds
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
job_id |
是 |
String |
构建任务ID。获取方法,请参考根据组件名称获取构建任务列表。 |
请求消息
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 |
构建任务名称。 |
|
index |
Integer |
构建在其任务下的索引号。 |
|
started_at |
String |
开始时间。 |
|
ended_at |
String |
结束时间。 |
|
duration |
Integer |
构建持续时间。 |
|
state |
String |
当前状态。
|
|
progress |
Number |
构建进度。 |
|
commit_id |
String |
代码提交ID。 |
|
committer |
String |
代码提交者。 |
请求示例
无
响应示例
{
"build_id": "j25yx7qm6apcxin59e3mj7u5byymtjjwsep6r5x2",
"job_id": "ctilzkwzcs2u22xjr6zh9iroixz2cikbjcd3103l",
"job_name": "scscscs",
"index": 2,
"started_at": "2025-11-14 09:06:28 +0000 UTC",
"ended_at": "",
"duration": 0,
"state": "Building",
"progress": 0,
"commit_id": "",
"committer": ""
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
操作成功。 |
|
400 |
错误的请求。 |
错误码
请参考ServiceStage错误码。