接口描述
该接口用于在事件总线中推送具体事件。
请求结构
- method:POST
- 请求URL:/v1/event-bus/event/recv
请求参数
名称 |
类型 |
描述 |
是否必须 |
参数位置 |
eventList |
List<CloudEvent> |
事件总线内事件结构 |
是 |
Body参数 |
CloudEvent
名称 |
类型 |
描述 |
是否必须 |
参数位置 |
data |
Map<String, Object> |
事件内容。JSON对象,内容由发起事件的用户或者服务决定。CloudEvents可能包含事件发生时由事件生产者给定的上下文,data中封装了这些信息。可以为空。 |
否 |
参数 |
id |
String |
事件ID。标识事件的唯一值。发送端必须确保source+id是唯一的。可以为空,为空时系统自动生成。 |
否 |
参数 |
source |
String |
事件源。提供事件的服务。标识事件发生的内容。 |
是 |
参数 |
specversion |
String |
CloudEvents协议版本。可以为空。 |
否 |
参数 |
type |
String |
事件类型。描述事件源相关的事件类型。 |
是 |
参数 |
datacontenttype |
String |
参数data的内容形式。datacontenttype只支持application/json格式。可以为空。 |
否 |
参数 |
subject |
String |
事件主体。JSON数据包含标识事件中涉及的资源的标识。可以为空。 |
否 |
参数 |
time |
String |
发生事件的时间,例如2020-11-19T21:04:41Z。默认值,系统接受到事件的时间。可以为空。 |
否 |
参数 |
resourceType |
String |
云产品子类型,用户自定义事件中该值可为空。可以为空。 |
否 |
参数 |
level |
EventLevel |
事件级别,用户自定义可以为空。 |
否 |
参数 |
accountId |
String |
云账号ID。可以为空。默认从请求头中获取。 |
否 |
参数 |
eventBusId |
String |
接收事件的事件总线Id。 |
是 |
参数 |
eventBusName |
String |
接收事件的事件总线名称。可以为空。 |
否 |
参数 |
eventSourceAlias |
String |
事件源的中文别称。可以为空。 |
否 |
参数 |
eventAlias |
String |
事件类型的中文别称。可以为空。 |
否 |
参数 |
eventAliasEn |
String |
事件类型的英文别称。可以为空。 |
否 |
参数 |
region |
String |
事件的地域。可以为空。 |
否 |
参数 |
recvTimestamp |
String |
接受到事件的时间戳。2020-11-19T21:04:41+08:00 |
否 |
参数 |
响应参数
名称 |
类型 |
描述 |
events |
List<CloudEvent> |
推送事件 |
请求示例
{
"eventList": [
{
"data": "{\"info\":\"系统出现异常\",\"advice\":\"请联系管理员\"}",
"source": "App_DEMO",
"type": "DEMO_EVENT",
"id": "45ef4dewdwe1-7c35-447a-bd93-fab****",
"subject": "qcs::dts:ap-guangzhou:appid12312/uid1250000000:xxx",
"time": 1615430559146,
"region": "bj"
},
...
],
"eventBusId": "eb-xxxxxx"
}
响应示例
{
"events": [
{
"data": {
"info": "系统出现异常",
"advice": "请联系管理员"
},
"id": "45ef4dewdwe1-7c35-447a-bd93-fab****",
"source": "source1",
"type": "DEMO_EVENT",
"subject": "qcs::dts:ap-guangzhou:appid12312/uid1250000000:xxx",
"time": "2023-01-01T00:00:00+0800",
"eventBusId": "bus1",
"eventBusName": "busName1",
"eventAlias": "eventAlias1",
"eventAliasEn": "eventAliasEn1",
"region": "region1",
},
...
]
}