Publishes one or more events.
URI
/openapi/putEvents
Limits
- The maximum size of an event that can be published is 64 KB. This complies with the requirement specified in the CloudEvents specification.
- The maximum number of events that can be published in a request is 16.
- The maximum total size of events that can be published in a request is 256 KB, which is equivalent to 262,144 bytes.
Request parameters
| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
| datacontenttype | String | No | application/json | The content type of the data parameter. Set the value of this parameter to application/json. |
| data | Struct | No | test | The content of the event. |
| subject | String | No | acs:oss:cn-hangzhou:123456789098****:xls-papk/game_apk/123.jpg | The subject of the event. |
| specversion | String | Yes | 1.0 | The version of the CloudEvents specification. |
| aliyuneventbusname | String | Yes | mybus | The name of the event bus that receives the event. |
| id | String | Yes | a5074581-7e74-4e4c-868f-47e7afdf**** | The ID of the event. |
| source | String | Yes | acs.oss | The event source. |
| time | Timestamp | Yes | 2020-08-24T13:54:05.965Asia/Shanghai | The time when the event occurred. |
| type | String | Yes | oss:ActionTrail:ApiCall | The type of the event. |
Note For more information about the limits on the parameters, see Limits.
Response parameters
| Parameter | Type | Example | Description |
|---|---|---|---|
| RequestId | String | 5E9AB1DF333245F1D800**** | The ID of the request. This parameter is a common parameter. Each request has a unique ID. |
| FailedEntryCount | Int | 0 | The number of events that failed to be processed. |
| EntryList | List | The information about the event body. | |
| EventId | String | 99418e3a-2025-41c6-a914-b8d6568e**** | The ID of the event. |
| TraceId | String | 445EFED2EC2A7FC17FB05AF4AD01**** | The ID of the trace. This parameter is used for troubleshooting. |
Examples
Sample requests
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"
}
]Sample responses
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****"
}
]
}