# 查询流水线执行状态
#### 功能介绍
此API用于查询流水线的某次执行状态。
#### URI
GET /cpepipeline/v2/pipelines/{pipeline_id}/state
表1路径参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                   |
|:---|:---|:---|:---|
| pipeline_id | 是    | String | 流水线ID。获取方法，请参考[查询流水线列表](https://support.huaweicloud.com/api-servicestage/servicestage_06_0294.html)。 |
   
表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](https://support.huaweicloud.com/api-iam/iam_30_0001.html)。 |
   
#### 响应消息
表4响应参数 
| 参数          | 参数类型             | 描述                                                         |
|:---|:---|:---|
| id          | Integer          | 执行ID。                                                      |
| pipelineId  | String           | 流水线ID。                                                     |
| status      | Integer          | 流水线状态。                                                     |
| version     | Integer          | 流水线版本。                                                     |
| trigger     | String           | 执行者。                                                       |
| triggerType | Integer          | 执行类型。                                                      |
| triggerAt   | Integer          | 执行时间。                                                      |
| queryAt     | Integer          | 查询时间。                                                      |
| stageStates | Array of objects | 阶段状态，详情请见[表5]。 |
   
 表5stageStates 
| 参数                    | 参数类型             | 描述                                                       |
|:---|:---|:---|
| name                  | String           | 阶段名称。                                                    |
| approvalStatus        | Integer          | 审批类型。                                                    |
| status                | Integer          | 阶段状态。                                                    |
| id                    | Integer          | 阶段执行ID。                                                  |
| pipeline_execution_id | Integer          | 流水线执行ID。                                                 |
| taskStates            | Array of objects | 任务状态，详情请见[表6]。 |
   
 表6taskStates 
| 参数                   | 参数类型    | 描述      |
|:---|:---|:---|
| 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错误码](https://support.huaweicloud.com/api-servicestage/servicestage_06_0162.html)。