
# 获取执行中的构建步骤日志 - ShowActionInfo
#### 功能介绍
获取指定构建任务执行中的构建步骤日志。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-codeci/cloudbuild_03_0007.html)。
#### 授权信息
当前API调用无需身份策略权限。
#### URI
GET /v1/log/task/step
表1Query参数 
| 参数           | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|:---|
| job_id       | 是    | String  | **参数解释**： 填写需要查询构建历史列表的构建任务ID。获取方法：在构建历史列表页面，拷贝浏览器URL中"/detail/history/"之后的32位数字、字母组合的字符串，即为构建任务ID。 **约束限制**： 不涉及。 **取值范围**： 只能是英文字母和数字，长度为32个字符。 **默认取值**： 不涉及。 |
| build_no     | 是    | Integer | **参数解释**： 构建任务的构建编号，从1开始，每次构建递增1。 **约束限制**： 正整数。 **取值范围**： 只能使用数字，大于等于1。 **默认取值**： 1                                                                             |
| step_id      | 是    | Integer | **参数解释**： 步骤id。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。                                                                                                     |
| start_offset | 是    | Integer | **参数解释**： 起始偏移量，表示从此开始查询。 **约束限制**： 不涉及。 **取值范围**： 只能使用数字，大于等于0。 **默认取值：** 0                                                                                     |
| end_offset   | 是    | Integer | **参数解释**： 结束偏移量，表示查询到此结束。 **约束限制**： 不涉及。 **取值范围**： 只能使用数字，大于等于0。 **默认取值：** 0                                                                                     |
| sort         | 否    | String  | **参数解释**： 排序方式。 **约束限制**： 不涉及。 **取值范围**： ● ASC：正向排序。 ● DESC：逆向排序。 **默认取值**： DESC                                               |
| size         | 是    | String  | **参数解释**： 可控制返回内容长度，默认值为1000。 **约束限制**： 不涉及。 **取值范围**： 只能使用数字，大于等于0。 **默认取值**： 1000                                                                              |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数     | 参数类型                                              | 描述                                                                                                                                     |
|:---|:---|:---|
| result | [result] object | 结果                                                                                                                                     |
| error  | Object                                            | **参数解释**： 返回错误信息。 **取值范围**： 不涉及。 |
| status | String                                            | **参数解释**： 返回状态信息。 **取值范围**： 不涉及。 |
   
 表3result 
| 参数           | 参数类型    | 描述                                                                                                                                                                                                         |
|:---|:---|:---|
| has_more     | Boolean | **参数解释**： 是否还有剩余日志标识。 **取值范围**： ● true：有剩余日志标识。 ● false：没有有剩余日志标识。 |
| start_offset | String  | **参数解释**： 日志查询起始偏移量。 **取值范围**： 数字组成。                                                                 |
| end_offset   | String  | **参数解释**： 日志查询结束偏移量。 **取值范围**： 数字组成。                                                                 |
| log          | String  | **参数解释**： 返回日志内容，可能会空，请再次请求。 **取值范围**： 不涉及。                                                          |
| location     | String  | **参数解释**： 日志来源。 **取值范围**： 不涉及。                                                                       |
   
#### 请求示例
```
GET https://{endpoint}/v1/log/task/step
```
#### 响应示例
**状态码：200**
OK
```
{
  "result" : {
    "start_offset" : 0,
    "end_offset" : 24351,
    "log" : "[2025/06/26 14:23:32.169 GMT+08:00] [INFO] [代码检出:external_pre_checkout] : 该步骤开始执行\n[2025/06/26 14:23:32.172 GMT+08:00]...",
    "has_more" : false,
    "location" : "jenkins"
  },
  "error" : null,
  "status" : "success"
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-codeci/ErrorCode.html)。
