文档首页/ 流水线 CodeArts Pipeline/ API参考/ API/ 流水线管理/ 修改通用webhook开关 - SwitchGenericWebhook
更新时间：2026-09-18 GMT+08:00
在线调试
CLI示例
查看PDF
分享

修改通用webhook开关 - SwitchGenericWebhook

功能介绍

修改通用webhook开关

调用方法

请参见如何调用API。

URI

POST /v5/{project_id}/api/pipelines/{pipeline_id}/webhook/switch

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目ID，获取方式请参见获取项目ID。

约束限制：

不涉及。

取值范围：

32位字符，由数字和字母组成。

默认取值：

不涉及。

pipeline_id

是

String

参数解释：

流水线ID，可以通过查询流水线列表接口，其中pipelines.pipelineId即为流水线ID。

约束限制：

不涉及。

取值范围：

32位字符，仅由数字和字母组成。

默认取值：

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

webhook_switch

是

Boolean

参数解释：

是否打开webhook开关。

约束限制：

不涉及。

取值范围：

  • true：已打开webhook开关。

  • false：未打开webhook开关。

默认取值：

不涉及。

use_iam

是

Boolean

参数解释：

是否使用IAM鉴权。

约束限制：

不涉及。

取值范围：

  • true：使用IAM鉴权。

  • false：不使用IAM鉴权。

默认取值：

不涉及。

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

status

String

参数解释：

返回状态。

取值范围：

不涉及。

请求示例

POST https://{endpoint}/v5/93b9fc6ffc6a4edc9ab049c1f0dbec4b/api/pipelines/4a5350af4b5041d4a7fdea16d6938eb0/webhook/switch

{
  "webhook_switch" : false,
  "use_iam" : true
}

响应示例

状态码：200

{
  "status" : "success"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 流水线管理