修改流水线实例级别消息通知配置 - UpdatePipelineNoticeConf
功能介绍
修改流水线实例级别消息通知配置
调用方法
请参见如何调用API。
URI
PUT /v5/{project_id}/api/pipeline-notices/{pipeline_id}/notice/update
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
type |
否 |
Integer |
参数解释: 流水线消息通知类型。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
|
event |
否 |
EventStatusDTO object |
参数解释: 第三方通知事件配置。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
webhook_config |
否 |
ThirdPartEventDTO object |
参数解释: 第三方通知事件配置。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
id |
否 |
String |
参数解释: 事件类型。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
|
selected |
否 |
Boolean |
参数解释: 是否启用事件通知。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
|
notice_roles |
否 |
Array of strings |
参数解释: 通知对象列表。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
notice_id |
否 |
String |
参数解释: 第三方通知配置ID,第三方通知的唯一标识。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
url |
否 |
String |
参数解释: 第三方通知URL地址,由对应第三方平台获取。 约束限制: URL地址只能以http://或者https://开头。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
events |
否 |
Array of strings |
参数解释: 流水线事件类型。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
|
options |
否 |
Array of strings |
参数解释: 通知内容列表。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
mentioned_list |
否 |
Array of strings |
参数解释: 第三方user_id列表,通过user_id使用半角逗号(,)分隔组成。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
mentioned_mobile_list |
否 |
Array of strings |
参数解释: 手机号列表。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
secret_info |
否 |
String |
参数解释: 加签密钥。 约束限制: 钉钉、飞书自定义机器人可以开启安全设置,若未使用加签,无需填写加签秘钥。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error |
ErrorInfo object |
参数解释: 错误信息,接口正常无报错时不返回error字段。 取值范围: 不涉及。 |
|
result |
Object |
参数解释: 返回结果。 取值范围: 不涉及。 |
|
status |
String |
参数解释: 状态值。 取值范围: 不涉及。 |
状态码:400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_msg |
String |
参数解释: 错误信息。 取值范围: 不涉及。 |
|
error_code |
String |
参数解释: 错误码。 取值范围: 不涉及。 |
请求示例
PUT https://(endpoint)/v5/e2e18230a85d4d6ab0b56cb6d2246c18/api/pipeline-notices/0747d5a7099e45f69dc1d099945909a9/notice/update
响应示例
无
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
|
400 |
Bad request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
错误码
请参见错误码。