更新时间:2025-10-13 GMT+08:00
分享

查询事件通知规则

功能介绍

查询事件通知规则。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v1/{project_id}/cae/notice-rules/{rule_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取项目ID请参见获取项目ID

rule_id

String

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

  • 获取Token,请参考《统一身份认证服务API参考》的“获取用户Token”章节。
    • 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

X-Enterprise-Project-ID

String

企业项目ID。

  • 创建环境时,环境会绑定企业项目ID。

  • 最大长度36字节,带“-”连字符的UUID格式,或者是字符串“0”。

  • 该字段不传(或传为字符串“0”)时,则查询默认企业项目下的资源。

说明:
关于企业项目ID的获取及企业项目特性的详细信息,请参见《企业管理服务用户指南》。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

api_version

String

API版本,固定值“v1”,该值不可修改。

kind

String

API类型,固定值“NoticeRule”,该值不可修改。

spec

CreateNoticeRuleRespItem object

请求数据。

表4 CreateNoticeRuleRespItem

参数

参数类型

描述

id

String

通知规则的唯一标识。

name

String

通知名称。

event_name

String

触发事件名称。

scope

NoticeRuleScope object

生效的通知规则范围。

trigger_policy

TriggerPolicy object

触发策略。

notification

NoticeRuleNotification object

通知的机制。

enable

Boolean

是否启用。

表5 NoticeRuleScope

参数

参数类型

描述

type

String

生效范围的类型。包括environments(对指定环境下所有组件生效),applications(对指定应用下所有组件生效),components(对指定的组件生效)。

environments

Array of strings

生效的环境id列表。

applications

Array of strings

生效的应用id列表。

components

Array of strings

生效的组件id列表。

表6 TriggerPolicy

参数

参数类型

描述

trigger_type

String

触发类型,accumulative: 累计触发,immediately: 立即触发。

period

Integer

触发周期,选择累计触发时需设置该参数,默认单位为s,支持5分钟、20分钟、1小时、4小时、24小时。

operator

String

比较符,支持'>'和'>='。

count

Integer

触发次数,选择累计触发时需设置该参数。

表7 NoticeRuleNotification

参数

参数类型

描述

protocol

String

参数解释:

通知的协议类型。

约束限制:

不涉及。

取值范围:

  • email:邮件

  • sms:短信

  • wechat:企业微信群消息

  • dingding:钉钉机器人

默认取值:

不涉及。

extension

extension object

endpoint

String

通知的终端地址。

email协议,接入点必须是邮件地址。

sms协议,接入点必须是一个电话号码。

wechat协议以及钉钉机器人场景,参考获取订阅终端

企业微信群消息以及钉钉机器人为SMN服务公测功能,需提交工单申请开通。

template

String

通知的模板语言。

ZH,中文。

EN,英文。

表8 extension

参数

参数类型

描述

sign_secret

String

在使用钉钉场景下,支持用户填写密钥字段。

请求示例

响应示例

状态码

状态码

描述

200

请求成功。

错误码

请参见错误码

相关文档