All Products
Search
Document Center

EventBridge:PutEvents

Last Updated:Sep 08, 2026

Sends events to an event bus.

Operation description

Sends one or more events to an event bus.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

EventBusName

string

Yes

The name of the event bus.

my-bus

EventList

array<object>

Yes

The list of events.

object

No

The list of events.

Data

any

No

The event payload.

{"orderId": "1001", "amount": 99.9}

DataContentType

string

No

The data format.

application/json

DataSchema

string

No

The data schema address.

https://example.com/schema/v1

Id

string

Yes

The event ID.

5a2c8f4e-0001

Source

string

Yes

The event source.

my.custom.source

SpecVersion

string

No

The protocol version.

1.0

Subject

string

No

The event subject.

order-1001

Time

string

No

The event time.

2026-08-04T10:00:00Z

Type

string

Yes

The event type.

order:created

Response elements

Element

Type

Description

Example

object

Code

string

The status code. A value of 200 indicates success.

200

Data

object

The returned data.

EntryList

array<object>

The collection of event sending results.

object

The sending result of each event.

ErrorCode

string

The error code.

Success indicates success. Other values indicate exceptions

ErrorMessage

string

The detailed error description.

triggerPicture failed

EventId

string

The event ID.

4c8b7500-2aea-4f5a-b7dd-9d9dd986c07d

TraceId

string

The trace ID, which is used to query the exact call information.

4E17C677F5357FB23D1A7FF964CD1999

FailedEntryCount

integer

The number of events that failed to be sent.

2

Message

string

The error message.

EventBusNotExist

RequestId

string

The unique identifier that Alibaba Cloud generated for the request.

2BC1857D-E633-5E79-B2C2-43EF5F7730D8

Success

boolean

Indicates whether the operation was successful. Valid values: true: The operation was successful. false: The operation failed.

true

Examples

Success response

JSON format

{
  "Code": "200",
  "Data": {
    "EntryList": [
      {
        "ErrorCode": "Success代表成功,其他代表异常",
        "ErrorMessage": "triggerPicture failed",
        "EventId": "4c8b7500-2aea-4f5a-b7dd-9d9dd986c07d",
        "TraceId": "4E17C677F5357FB23D1A7FF964CD1999"
      }
    ],
    "FailedEntryCount": 2
  },
  "Message": "EventBusNotExist",
  "RequestId": "2BC1857D-E633-5E79-B2C2-43EF5F7730D8",
  "Success": true
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.