# 查询流水线任务日志 - ShowPipelineExecLog #### 功能介绍 查询流水线任务日志 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-pipeline/pipeline_03_0006.html)。 #### URI POST /v5/{project_id}/api/pipelines/{pipeline_id}/pipeline-runs/{pipelineRunId}/jobs/{jobRunId}/steps/{stepRunId}/exec-log 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释**： 项目ID，获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-pipeline/pipeline_03_0036.html)。 **约束限制**： 不涉及。 **取值范围**： 32位字符，由数字和字母组成。 **默认取值**： 不涉及。 | | pipeline_id | 是 | String | **参数解释**： 流水线ID，可以通过[查询流水线列表](https://support.huaweicloud.com/api-pipeline/ListPipelines.html)接口获取，其中pipelines.pipelineId即为流水线ID。 **约束限制**： 不涉及。 **取值范围**： 32位字符，由数字和字母组成。 **默认取值**： 不涉及。 | | pipelineRunId | 是 | String | **参数解释**： 流水线运行实例ID，[启动流水线](https://support.huaweicloud.com/api-pipeline/RunPipeline.html)接口的返回值即为流水线运行实例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 | 响应体 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-pipeline/ErrorCode.html)。