# 示例2：停止流水线
#### 场景描述
本章将指导您通过API根据流水线ID停止流水线任务。
API的调用方法请参见[4.2.5如何调用AP](https://support.huaweicloud.com/api-pipeline/pipeline_03_0006.html)。
#### 约束限制
已有流水线，并且流水线正在执行中。
#### 涉及接口
通过用户token、流水线id[停止流水线](https://support.huaweicloud.com/api-pipeline/StopPipelineNew.html)。
#### 操作步骤
1. 查看项目下构建任务列表。 
   - 接口信息 URI：POST /v3/pipelines/stop
     API文档详情请参见：[停止流水线](https://support.huaweicloud.com/api-pipeline/StopPipelineNew.html)。
     API Explorer在线调试请参见： [停止流水线](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=CloudPipeline&api=StopPipeline)。
     
   
   - 请求示例
     ```
     https://cloudpipeline-ext.cn-north-1.myhuaweicloud.com/v3/pipelines/stop?pipeline_id=824e784b3f43492e99152a.....
     ```
     
   
   - 请求体示例
     ```
     {}
     ```
     
   
   - 响应示例
     ```
     {
         "result": {
             "name": "pipeline-test",
             "pipelineId": "e9bdc806955e48368e3ecbcdf2...."
         },
         "error": null,
         "status": "success"
     }
     ```