更新时间:2025-08-19 GMT+08:00
分享

查询流水线任务日志

功能介绍

查询流水线任务日志

调用方法

请参见如何调用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

参数解释

偏移量。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

响应参数

状态码: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

响应体

错误码

请参见错误码

相关文档