更新时间:2024-09-04 GMT+08:00
分享

下载构建实时日志

功能介绍

下载构建实时日志

调用方法

请参见如何调用API

URI

GET /v3/jobs/{job_id}/{build_no}/real-time-log

表1 路径参数

参数

是否必选

参数类型

描述

job_id

String

参数解释

填写构建任务ID。获取方法:在构建任务详情页,拷贝浏览器URL末尾的32位数字、字母组合的字符串,即为构建任务ID。

约束限制

不涉及。

取值范围

只能是英文字母和数字,长度为32个字符。

build_no

Integer

参数解释

构建任务的构建编号,从1开始,每次构建递增1。

约束限制

不涉及。

取值范围

只能使用数字,大于等于1。

默认取值:

1

表2 Query参数

参数

是否必选

参数类型

描述

offset

Integer

偏移量,传入前一次请求返回的offset

length

Integer

可控制返回内容长度,默认值为1000000

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释

用户Token。(响应消息头中X-Subject-Token的值)。通过调用IAM服务接口获取。

约束限制

不支持租户全局token,请使用scope为project的region级token。

取值范围

不涉及。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

result

result object

结果

error

String

返回错误信息

status

String

返回状态信息

表5 result

参数

参数类型

描述

has_more_data

String

是否还有剩余日志标识

offset

String

偏移量,可用于一次请求

content

String

返回日志内容,可能会空,请再次请求

current_offset

String

当前请求偏移量

状态码: 400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码: 401

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码: 403

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码: 404

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码: 500

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

POST https://{endpoint}/v3/jobs/48c66c6002964721be537cdc6ce0297b/33/real-time-log

响应示例

状态码: 200

OK

{
  "result" : {
    "has_more_data" : true,
    "offset" : 126548,
    "content" : "[2023/12/21 15:44:18.743 GMT+08:00] [INFO] Building jar: ***//target/server-1.0.jar\\n[2023/12/21 15:44:18.744 GMT+08:00] [INFO] ------------------------------------------------------------------------\\n[2023/12/21 15:44:18.744 GMT+08:00] [INFO] BUILD SUCCESS\\n[2023/12/21 15:44:18.744 GMT+08:00] [INFO] ------------------------------------------------------------------------\\n[2023/12/21 15:44:18.744 GMT+08:00] [INFO] Total time: 5.408 s\\n[2023/12/21 15:44:18.744 GMT+08:00] [INFO] Finished at: 2023-12-21T15:44:18+08:00\\n[2023/12/21 15:44:18.744 GMT+08:00] [INFO] ------------------------------------------------------------------------\\n[2023/12/21 15:44:18.793 GMT+08:00] [INFO] [Maven构建:external_post_maven] : 该步骤开始执行。\\n[2023/12/21 15:44:18.796 GMT+08:00] [INFO] [Maven构建:external_post_maven] : 参数初始化成功。\\n[2023/12/21 15:44:18.796 GMT+08:00] [INFO] [Maven构建:external_post_maven] : 插件上下文初始化成功。\\n[2023/12/21 15:44:18.797 GMT+08:00] [INFO] [Maven构建:external_post_maven] : 该步骤执行完成。\\n[2023/12/21 15:44:18.842 GMT+08:00] $ docker stop --time=1 8db533bfed323ffeb24d4698b65af3b4d6f138c9e7c0297ee9e33442648b87ea\\n",
    "current_offset" : 121768
  },
  "error" : null,
  "status" : "success"
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档