使用PutEvents发布事件。

URI

/openapi/putEvents

使用限制

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

请求参数

名称 类型 是否必选 示例值 描述
EventBusName String bus2 事件总线(EventBus)名称。详情请参见使用限制
EventList List List<Event> 事件详情。

Event是对CloudEvents1.0协议的实现,字段如下所示。

表 1. Event数据集
名称 类型 是否必选 示例值 描述
id String 99418e3a-2025-41c6-a914-b8d6568e9f00 事件ID。详情请参见使用限制
source URI acs.oss 事件源描述。长度最大128字符。
specversion String 1.0(默认值) CloudEvents协议版本。
type String oss:ObjectCreated:PostObject 事件类型。长度最大64字符。
subject String acs:oss:cn-hangzhou:123456789098****:xls-papk/game_apk/123.jpg 事件发生的资源描述。长度最大128字符。
time Date 2020-04-18T07:53:02.373Z 事件发生时间,需满足ISO8601标准。
data Object test 使用的事件数据。

返回参数

名称 类型 示例值 描述
RequestId String 5E97BCDF303739C812000001 为公共参数,每个请求的ID都是唯一的。
FailedEntryCount Int 0 处理失败的事件数。
EntryList List List<PutEventsResponseEntry> 事件体信息。
表 2. EntryList数据结构列表
名称 类型 是否必选 示例值 描述
EventId String 99418e3a-2025-41c6-a914-b8d6568e9f00 事件ID。
TraceId String 445EFED2EC2A7FC17FB05AF4AD010000 轨迹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: EVENTBRIDGE vZ3VL0SuJdHiEmvU:Jo2PbTjR******YAYoYslKLvWzg=
Content-Type: text/xml;charset=UTF-8
Content-Length: 418

{
    "EventList": [{
        "data": "test",
        "id": "99418e3a-2025-41c6-a914-b8d6568e9f00",
        "source": "acs.oss",
        "specversion": "1.0",
        "type": "oss:ObjectCreated:PostObject",
        "subject": "acs:oss:cn-hangzhou:123456789098****:xls-papk/game_apk/123.jpg",
        "time": "2020-04-18T07:53:02.373Z"
        }
    }],
    "EventBusName": "bus2"
}

返回示例

HTTP/1.1 200 OK
Server: AliyunEventBridge
Connection: keep-alive
Content-Type: application/json;charset=utf-8
Content-Length: 171
x-eventbridge-request-id: 5E9AB1DF333245F1D8000040
Date: Sat, 18 Apr 2020 05:30:41 GMT

{
    "RequestId": "5E9AB1DF333245F1D8000040",
    "FailedEntryCount": 0,
    "EntryList": [{
        "EventId": "99418e3a-2025-41c6-a914-b8d6568e9f00",
        "TraceId": "445EFED2EC2A7FC17FB05AF4AD010000"
    }]
}