流水线消息通知根据类型查询详情 - GetPipelineMessageNoticeByType
功能介绍
根据消息通知类型,查询流水线具体通知配置详情
调用方法
请参见如何调用API。
URI
GET /v5/{project_id}/api/pipeline-notices/{pipeline_id}/notice/detail
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 项目ID,获取方式请参见获取项目ID。 约束限制: 不涉及。 取值范围: 32位字符,由数字和字母组成。 默认取值: 不涉及。 |
|
pipeline_id |
是 |
String |
参数解释: 流水线ID,可以通过查询流水线列表接口获取,其中pipelines.pipelineId即为流水线ID。 约束限制: 不涉及。 取值范围: 32位字符,由数字和字母组成。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
type |
是 |
Integer |
参数解释: 流水线消息通知类型。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
请求参数
无
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
参数解释: 加签密钥。 约束限制: 钉钉、飞书自定义机器人可以开启安全设置,若未使用加签,无需填写加签秘钥。 取值范围: 不涉及。 默认取值: 不涉及。 |
状态码:400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_msg |
String |
参数解释: 错误信息。 取值范围: 不涉及。 |
|
error_code |
String |
参数解释: 错误码。 取值范围: 不涉及。 |
请求示例
GET https://(endpoint)/v5/e2e18230a85d4d6ab0b56cb6d2246c18/api/pipeline-notices/0747d5a7099e45f69dc1d099945909a9/notice/detail
响应示例
状态码:200
OK
{
"events" : [ {
"id" : "pipeline.updated",
"name" : null,
"selected" : false,
"english_name" : null,
"resource_role_receivers" : null
}, {
"id" : "pipeline.deleted",
"name" : null,
"selected" : false,
"english_name" : null,
"resource_role_receivers" : null
}, {
"id" : "pipelineRun.succeed",
"name" : null,
"selected" : false,
"english_name" : null,
"resource_role_receivers" : null
}, {
"id" : "pipelineRun.failed",
"name" : null,
"selected" : false,
"english_name" : null,
"resource_role_receivers" : null
} ],
"webhook_config" : null
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
|
400 |
Bad request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
错误码
请参见错误码。