# 获取构建任务实例详情
#### 功能介绍
此API用于根据构建任务实例ID获取构建任务实例详情
#### URI
GET /assembling/v1/builds/{build_id}
参数说明见[表1]
 表1路径参数 
| 参数       | 是否必选 | 参数类型   | 描述                                                                                                                 |
|:---|:---|:---|:---|
| build_id | 是    | String | 构建任务实例ID。获取方法，请参考[根据构建任务ID获取构建任务实例列表](https://support.huaweicloud.com/api-servicestage/servicestage_06_0219.html)。 |
   
请求消息
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                           |
|:---|:---|:---|:---|
| Content-Type | 是    | String | 消息体的类型（格式），默认取值为"application/json;charset=utf8"。                                                                                             |
| X-Auth-Token | 是    | String | 调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值。Token获取方式，请参考[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)。 |
   
#### 响应消息
表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 | 代码仓类型。 - DevCloud，codearts制品仓。  - Gitee，开源中国推出代码托管平台。    - GitHub，开源代码仓。  - GitLab，开源代码仓。  - Bitbucket，源代码托管网站。   |
| 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 | 错误的请求。 |
   
#### 错误码
请参考[ServiceStage错误码](https://support.huaweicloud.com/api-servicestage/servicestage_06_0162.html)。