任务执行后获取构建步骤日志
功能介绍
任务执行后,获取指定构建任务的构建步骤日志。
调用方法
请参见如何调用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 |
错误码
请参见错误码。