
# 获取任务失败时错误日志 - ShowLogAnalysis
#### 功能介绍
获取指定构建任务失败时的错误日志。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-codeci/cloudbuild_03_0007.html)。
#### 授权信息
当前API调用无需身份策略权限。
#### URI
GET /v1/log/{job_id}/{build_no}/analysis
表1路径参数 
| 参数       | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| job_id   | 是    | String  | **参数解释**： 填写需要查询构建历史列表的构建任务ID。获取方法：在构建历史列表页面，拷贝浏览器URL中"/detail/history/"之后的32位数字、字母组合的字符串，即为构建任务ID。 **约束限制**： 不涉及。 **取值范围**： 只能是英文字母和数字，长度为32个字符。 **默认取值**： 不涉及。 |
| build_no | 是    | Integer | **参数解释**： 构建任务的构建编号，从1开始，每次构建递增1。 **约束限制**： 正整数。 **取值范围**： 只能使用数字，大于等于1。 **默认取值**： 1                                                                             |
   
表2Query参数 
| 参数     | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| limit  | 否    | Integer | **参数解释**： 每页显示的条目数量，limit大于0小于等于100。 **约束限制**： 不涉及。 **取值范围**： 只能使用数字，大于0小于等于100。 **默认取值：** 10 |
| offset | 否    | Integer | **参数解释**： 分页页码，表示从此页开始查询。 **约束限制**： 不涉及。 **取值范围**： 只能使用数字，大于等于0。 **默认取值：** 0                  |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数     | 参数类型                                               | 描述                                                                                                                                        |
|:---|:---|:---|
| result | [result] object | **参数解释**： 结果。 **取值范围**： 不涉及。     |
| error  | Object                                             | **参数解释**： 返回错误信息。 **取值范围**： 不涉及。 |
| status | String                                             | **参数解释**： 返回状态信息。 **取值范围**： 不涉及。 |
   
 表4result 
| 参数          | 参数类型                                                                       | 描述                                                                                                                                           |
|:---|:---|:---|
| job_name    | String                                                                     | **参数解释**： 构建任务名。 **取值范围**： 字母和字符组成。 |
| error_nodes | Array of [AnalysisError] objects | **参数解释**： 任务错误信息合集。 **取值范围**： 不涉及。  |
   
 表5AnalysisError 
| 参数               | 参数类型                                                       | 描述                                                                                                                                                                                             |
|:---|:---|:---|
| node_id          | String                                                     | **参数解释**： 节点id信息。 **取值范围**： 不涉及。                                                      |
| step             | String                                                     | **参数解释**： 步骤。 **取值范围**： 不涉及。                                                          |
| analyzed_success | Boolean                                                    | **参数解释**： 分析成功标识。 **取值范围**： ● true：成功。 ● false：失败。 |
| error_info       | [error_info] object | **参数解释**： 错误信息。 **取值范围**： 不涉及。                                                        |
   
 表6error_info 
| 参数            | 参数类型   | 描述                                                                                                                                      |
|:---|:---|:---|
| error_code    | String | **参数解释**： 错误码。 **取值范围**： 不涉及。  |
| error_message | String | **参数解释**： 错误日志。 **取值范围**： 不涉及。 |
| faq           | String | **参数解释**： 常见问题。 **取值范围**： 不涉及。 |
   
#### 请求示例
```
GET https://{endpoint}/v1/log/{job_id}/{build_no}/analysis
```
#### 响应示例
**状态码：200**
OK
```
{
  "result" : {
    "job_name" : "j_JbgkmAfe",
    "error_nodes" : [ {
      "step" : "releasemanArtifactsUploader",
      "node_id" : 114,
      "analyzed_success" : true,
      "error_info" : {
        "faq" : null,
        "error_code" : "DEV.CB.0220021",
        "error_message" : "DEV.CB.0220021,未找到文件,可能文件路径不对:build/*"
      }
    }, {
      "step" : "releasemanArtifactsUploader",
      "node_id" : 82,
      "analyzed_success" : true,
      "error_info" : {
        "faq" : null,
        "error_code" : "DEV.CB.0210032",
        "error_message" : "文件校验失败"
      }
    } ]
  },
  "error" : null,
  "status" : "success"
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-codeci/ErrorCode.html)。
