調用PutEvents接口發布一個或多個事件。

URI

/openapi/putEvents

使用限制

  • 單個事件最大為64 KB，對齊CloudEvents協議要求。
  • 批量事件個數batchSize最大為16。
  • batch發送整體大小最大為256 KB（262144字節）。

請求參數

名稱類型是否必選示例值描述
datacontenttypeString否application/json參數data的內容形式。當前僅支持application/json格式。
dataStruct否test事件內容。
subjectString否acs:oss:cn-hangzhou:123456789098****:xls-papk/game_apk/123.jpg事件主題。
specversionString是1.0CloudEvents協議版本。
aliyuneventbusnameString是mybus接收事件的事件總線名稱。
idString是a5074581-7e74-4e4c-868f-47e7afdf****事件ID。
sourceString是acs.oss事件源。
timeTimestamp是2020-08-24T13:54:05.965Asia/Shanghai事件產生的時間。
typeString是oss: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****"
        }
    ]
}