调用PutEvents接口发布一个或多个事件。
URI
/openapi/putEvents
使用限制
- 单个事件最大为64 KB，对齐CloudEvents协议要求。
- 批量事件个数batchSize最大为16。
- batch发送整体大小最大为256 KB（262144字节）。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| datacontenttype | String | 否 | application/json | 参数data的内容形式。当前仅支持application/json格式。 |
| data | Struct | 否 | test | 事件内容。 |
| subject | String | 否 | acs:oss:cn-hangzhou:123456789098****:xls-papk/game_apk/123.jpg | 事件主题。 |
| specversion | String | 是 | 1.0 | CloudEvents协议版本。 |
| aliyuneventbusname | String | 是 | mybus | 接收事件的事件总线名称。 |
| id | String | 是 | a5074581-7e74-4e4c-868f-47e7afdf**** | 事件ID。 |
| source | String | 是 | acs.oss | 事件源。 |
| time | Timestamp | 是 | 2020-08-24T13:54:05.965Asia/Shanghai | 事件产生的时间。 |
| type | String | 是 | oss:ActionTrail:ApiCall | 事件类型。 |
说明 参数的相关使用限制，请参见使用限制。
返回参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 5E9AB1DF333245F1D800**** | 为公共参数，每个请求的ID都是唯一的。 |
| FailedEntryCount | Int | 0 | 处理失败的事件数。 |
| EntryList | List | 事件体信息。 | |
| EventId | String | 99418e3a-2025-41c6-a914-b8d6568e**** | 事件ID。 |
| TraceId | String | 445EFED2EC2A7FC17FB05AF4AD01**** | 轨迹ID。用于排查问题。 |
示例
请求示例
POST /openapi/putEvents HTTP/1.1
Host: 123456789098****.eventbridge.cn-hangzhou.aliyuncs.com
Date: Sat, 18 Apr 2020 05:30:41 GMT
x-eventbridge-version: 2020-04-01
Authorization: acs vZ3VL0SuJdHi****:Jo2PbTjR******YAYoYslKLvWzg=
Content-Type: application/cloudevents-batch+json;charset=UTF-8
Content-Length: 418
[
{
"datacontenttype":"application/json",
"data":"test",
"subject":"acs:oss:cn-hangzhou:123456789098****:xls-papk/game_apk/123.jpg",
"specversion":"1.0",
"aliyuneventbusname":"mybus",
"id":"a5074581-7e74-4e4c-868f-47e7afdf****",
"source":"acs.oss",
"time":"2020-08-24T13:54:05.965Asia/Shanghai",
"type":"oss:ActionTrail:ApiCall"
}
]返回示例
HTTP/1.1 200 OK
Server: AliyunEventBridge
Connection: keep-alive
Content-Type: application/json;charset=utf-8
Content-Length: 171
x-eventbridge-request-id: 5E9AB1DF333245F1D800****
Date: Sat, 18 Apr 2020 05:30:41 GMT
{
"RequestId":"5E9AB1DF333245F1D800****",
"FailedEntryCount":0,
"EntryList":[
{
"EventId":"99418e3a-2025-41c6-a914-b8d6568e****",
"TraceId":"445EFED2EC2A7FC17FB05AF4AD01****"
}
]
}