调用PutEvents接口发布一个或多个事件。

URI

/openapi/putEvents

使用限制

  • 单个事件最大为64 KB,对齐CloudEvents协议要求。
  • 批量事件个数batchSize最大为16。
  • batch发送整体大小最大为256 KB(262144字节)。

请求参数

名称类型是否必选示例值描述
datacontenttypeStringapplication/json参数data的内容形式。当前仅支持application/json格式。
dataStructtest事件内容。
subjectStringacs:oss:cn-hangzhou:123456789098****:xls-papk/game_apk/123.jpg事件主题。
specversionString1.0CloudEvents协议版本。
aliyuneventbusnameStringmybus接收事件的事件总线名称。
idStringa5074581-7e74-4e4c-868f-47e7afdf****事件ID。
sourceStringacs.oss事件源。
timeTimestamp2020-08-24T13:54:05.965Asia/Shanghai事件产生的时间。
typeStringoss:ActionTrail:ApiCall事件类型。
说明 参数的相关使用限制,请参见使用限制

返回参数

名称类型示例值描述
RequestIdString5E9AB1DF333245F1D800****为公共参数,每个请求的ID都是唯一的。
FailedEntryCountInt0处理失败的事件数。
EntryListList事件体信息。
EventIdString99418e3a-2025-41c6-a914-b8d6568e****事件ID。
TraceIdString445EFED2EC2A7FC17FB05AF4AD01****轨迹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****"
        }
    ]
}