文档首页/ 流水线 CodeArts Pipeline/ API参考/ API/ 流水线管理/ 查询流水线任务日志 - ShowPipelineExecLog
更新时间:2026-09-18 GMT+08:00

查询流水线任务日志 - ShowPipelineExecLog

功能介绍

查询流水线任务日志

调用方法

请参见如何调用API。

URI

POST /v5/{project_id}/api/pipelines/{pipeline_id}/pipeline-runs/{pipelineRunId}/jobs/{jobRunId}/steps/{stepRunId}/exec-log

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID,获取方式请参见获取项目ID。

约束限制:

不涉及。

取值范围:

32位字符,由数字和字母组成。

默认取值:

不涉及。

pipeline_id

是

String

参数解释:

流水线ID,可以通过查询流水线列表接口获取,其中pipelines.pipelineId即为流水线ID。

约束限制:

不涉及。

取值范围:

32位字符,由数字和字母组成。

默认取值:

不涉及。

pipelineRunId

是

String

参数解释:

流水线运行实例ID,启动流水线接口的返回值即为流水线运行实例ID。

约束限制:

不涉及。

取值范围:

32位字符,由数字和字母组成。

默认取值:

不涉及。

jobRunId

是

String

参数解释:

流水线任务ID。

约束限制:

不涉及。

取值范围:

32位字符,由数字和字母组成。

默认取值:

不涉及。

stepRunId

是

String

参数解释:

流水线步骤ID。

约束限制:

不涉及。

取值范围:

32位字符,由数字和字母组成。

默认取值:

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

start_offset

否

Long

参数解释:

日志起始偏移。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

end_offset

否

Long

参数解释:

日志结束偏移。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

limit

是

Long

参数解释:

最大日志行数。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

sort

是

String

参数解释:

排序规则。

约束限制:

不涉及。

取值范围:

  • asc:按排序字段升序。

  • desc:按排序字段降序

默认取值:

不涉及。

offset

是

Long

参数解释:

偏移量。

约束限制:

不涉及。

取值范围:

offset大于等于0。

默认取值:

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

has_more

Boolean

参数解释:

是否有更多日志。

取值范围:

  • true:有更多日志。

  • false:没有更多日志。

end_offset

String

参数解释:

查询日志结束偏移。填入请求体end_offset字段,用于查询下一页日志。

取值范围:

不涉及。

start_offset

String

参数解释:

查询日志起始偏移。填入请求体start_offset字段,用于查询下一页日志。

取值范围:

不涉及。

log

String

参数解释:

日志内容。

取值范围:

不涉及。

step_run_id

String

参数解释:

所属步骤ID。

取值范围:

不涉及。

请求示例

POST https://{endpoint}/v5/e2e18230a85d4d6ab0b56cb6d2246c18/api/pipelines/dc73b5ed58a64ab7a469b9480e5f6632/pipeline-runs/80e0fbc621014b2d85d960e0a3a935ef/jobs/806b3a5f0d504030af0bcf9a81347d9c/steps/ab9ac44f82004f8b9ab5d5a492122581/exec-log

{
  "start_offset" : 0,
  "end_offset" : 0,
  "offset" : 0,
  "limit" : 500,
  "sort" : "asc"
}

响应示例

状态码:200

{
  "has_more" : true,
  "end_offset" : "5424",
  "start_offset" : "0",
  "log" : "[2024/06/20 17:26:35.044 GMT+08:00] [INFO]  : [JobStatusPlugin] onStarted:Status: Downloaded newer image for swzip-1.1.0",
  "step_run_id" : "ab9ac44f82004f8b9ab5d5a492122581"
}

状态码

状态码

描述

200

响应体

错误码

请参见错误码。