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

URI

/openapi/putEvents

使用限制

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

请求参数

名称 类型 是否必选 示例值 描述
datacontenttype String application/json 参数data的内容形式。
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****"
        }
    ]
}