启动构建任务

功能介绍

此API用于根据构建任务ID启动构建任务。

URI

POST /assembling/v1/jobs/{job_id}/builds

表1 路径参数
参数	是否必选	参数类型	描述
job_id	是	String	构建任务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	构建任务名称。
index	Integer	构建在其任务下的索引号。
started_at	String	开始时间。
ended_at	String	结束时间。
duration	Integer	构建持续时间。
state	String	当前状态。 NotStarted：未开始 Queuing：队列中 Building：构建中 Pushing：推送中 Successful：已成功 Failed：失败 Timeout：超时 Cancel：取消 Deleted：已删除
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": ""
}