全部產品
Search
文件中心

Alibaba Cloud DevOps:Webhook 觸發流水線

更新時間:Dec 17, 2025

本文主要介紹了如何使用Webhook觸發方式運行流水線。

前提條件

開啟配置Webhook觸發可以快捷的實現流水線自動化任務運行,使流水線任務運行更簡潔,做到無縫整合與高效部署。

高的 (17).png

重要

若您需要使用Webhook觸發運行流水線,請您先確保Webhook觸發開關是開啟狀態。Webhook觸發通常適用於代碼源以外的第三方工具調用,同時也支援自有系統配置後進行觸發運行流水線。

Webhook觸發運行流水線

方式一:通用Webhook觸發

啟用流水線Webhook觸發後,可以直接使用以下命令觸發運行流水線。

curl --header "Content-Type: application/json" --request POST --data "{}" http://flow-openapi.aliyun.com/pipeline/webhook/your-webhook

方式二:流水線源Webhook觸發

流水線源Webhook觸發的地址與代碼源觸發一致,您可以結合需求情境選擇配置即可。

方式三:環境變數Webhook觸發

Webhook觸發支援環境變數觸發,您可以使用預設的變數參數與預設值進行觸發;也可以在運行命令中自訂預設值,使用變數參數和新定義的預設值來觸發。具體操作如下圖:

高的 (35).png

  • 使用變數參數和新定義的預設值來觸發。

    curl --header "Content-Type: application/json" --request POST --data "{\"abc\":\"456\"}" http://flow-openapi.aliyun.com/pipeline/webhook/your-webhook
  • 觸發前樣本中的環境變數abc預設值123,觸發後的流水線列印變數值輸出456

    高的 (37).png

對於任意第三方對接,均可以通過以上方式觸發運行流水線。

常見問題

通過Webhook觸發流水線失敗,提示:許可權不足

當使用 Webhook 觸發流水線時,系統會預設以最近一次啟用 Webhook 觸發功能的使用者身份執行流水線,繼承該使用者的許可權上下文。如果該使用者權限不足或已被移除許可權,將導致觸發失敗。請按以下步驟更新許可權操作:

  1. 禁用Webhook觸發功能。

  2. 由可以成功運行流水線的使用者重新啟用Webhook觸發功能。

  3. 重新發起Webhook請求進行驗證。