任务执行后获取构建步骤日志
功能介绍
任务执行后,获取指定构建任务的构建步骤日志。
调用方法
请参见如何调用API。
URI
GET /v1/log/task/page
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
job_id |
是 |
String |
参数解释: 构建的任务ID。 编辑构建任务时,浏览器URL末尾的32位数字、字母组合的字符串。 约束限制: 不涉及。 取值范围: 浏览器URL末尾的32位数字、字母组合的字符串。 默认取值: 不涉及。 |
|
build_no |
是 |
Integer |
参数解释: 构建任务的构建编号,从1开始,每次构建递增1。 约束限制: 正整数。 取值范围: 只能使用数字,大于等于1。 默认取值: 1 |
|
step_id |
是 |
Integer |
参数解释: 步骤id。 约束限制: 不涉及。 取值范围: 不涉及。 |
|
start_offset |
是 |
Integer |
参数解释: 起始偏移量,表示从此开始查询。 约束限制: 不涉及。 取值范围: 只能使用数字,大于等于0。 默认取值: 0 |
|
end_offset |
是 |
Integer |
参数解释: 结束偏移量,表示查询到此结束。 约束限制: 不涉及。 取值范围: 只能使用数字,大于等于0。 默认取值: 0 |
|
sort |
否 |
String |
参数解释: 排序方式。 约束限制: 不涉及。 取值范围: ● AES:正向排序。 ● DESC:逆向排序。 |
请求参数
无
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
result |
result object |
结果 |
|
error |
String |
参数解释: 返回错误信息。 取值范围: 不涉及。 |
|
status |
String |
参数解释: 返回状态信息。 取值范围: 不涉及。 |
请求示例
GET https://{endpoint}/v1/log/task/page
响应示例
状态码: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 |
错误码
请参见错误码。