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

查询流水线执行状态

功能介绍

此API用于查询流水线的某次执行状态。

URI

GET /cpepipeline/v2/pipelines/{pipeline_id}/state

参数说明见表1

表1 路径参数

参数

是否必选

参数类型

描述

pipeline_id

String

流水线ID。获取方法,请参考查询流水线列表

表2 查询参数

参数

是否必选

参数类型

描述

name

String

流水线名称。

executionId

Integer

执行ID。

请求消息

表3 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

消息体的类型(格式),默认取值为“application/json;charset=utf8”。

X-Auth-Token

String

调用接口的认证方式分为Token和AK/SK两种,如果您使用的Token方式,此参数为必填,请填写Token的值。Token获取方式,请参考获取用户Token

响应消息

表4 响应参数

参数

参数类型

描述

id

Integer

执行ID。

pipelineId

String

流水线ID。

status

Integer

流水线状态。

version

Integer

流水线版本。

trigger

String

执行者。

triggerType

Integer

执行类型。

triggerAt

Integer

执行时间。

queryAt

Integer

查询时间。

stageStates

List of Object

阶段状态,详情请见表表5

表5 stageStates

参数

参数类型

描述

name

String

阶段名称。

approvalStatus

Integer

审批类型。

status

Integer

阶段状态。

id

Integer

阶段执行iD。

pipeline_execution_id

Integer

流水线执行ID。

taskStates

List of Object

任务状态,详情请见表表6

表6 taskStates

参数

参数类型

描述

name

String

任务名称。

entityUrl

String

任务路径。

revisionUrl

String

回滚路径。

startTime

Integer

开始时间。

endTime

Integer

结束时间。

errorDetails

String

错误信息。

externalExecutionId

String

扩展执行ID。

externalExecutionUrl

String

扩展执行路径。

progress

Integer

任务执行进度。

status

Integer

任务执行状态。

output

Object

执行结果。

请求示例

无。

响应示例

{
    "id": 288509,
    "pipelineId": "c4f1a0cb-49d7-4e62-b4d0-a922f638c867",
    "version": 1,
    "trigger": "servicestage_iam5",
    "triggerType": 0,
    "triggerAt": 1753102708464,
    "status": 4,
    "stageStates": [
        {
            "name": "Artifacts",
            "approvalStatus": 0,
            "status": 0,
            "id": 576845,
            "pipeline_execution_id": 288509,
            "taskStates": [
                {
                    "name": "ghy-test-comp-0626-3-62e353",
                    "entityUrl": "/servicestage/#/pipeline/joblist",
                    "revisionUrl": null,
                    "startTime": 1753102708486,
                    "endTime": 0,
                    "errorDetails": null,
                    "externalExecutionId": "32xenu4x5z341ro401zg32yainqk0frymy23qxsw",
                    "externalExecutionUrl": "/servicestage/#/pipeline/builddetail?id=32xenu4x5z341ro401zg32yainqk0frymy23qxsw&jobId=audzvfrtnru94o8jtb9g38svx0rezi86rq43ff8m&jobName=null",
                    "progress": 30,
                    "status": 4,
                    "output": null
                }
            ]
        }
    ],
    "queryAt": 1753102875180
}

状态码

状态码

描述

200

操作成功。

400

错误的请求。

404

请求对象不存在。

500

内部错误。

错误码

请参考ServiceStage错误码

相关文档