How to connect a custom event source to EventBridge in the EventBridge console - EventBridge

This topic describes how to connect a custom event source to EventBridge in the EventBridge console.

Prerequisites

EventBridge
- EventBridge is activated, and the required permissions are granted to a Resource Access Management (RAM) user. For more information, see Activate EventBridge and grant permissions to a RAM user.
Simple Message Queue (formerly MNS) (SMQ)
- SMQ is activated and the required permissions are granted to a RAM user. For more information, see Activate SMQ and authorize RAM users to access SMQ.
- A queue is created. For more information, see Create a queue.

Step 1: Create a custom event source

Log on to the EventBridge console. In the left-side navigation pane, click Event Buses.
In the top navigation bar, select a region. On the Event Buses page, click the name of the custom event bus that you want to manage.
In the left-side navigation pane, click Event Sources and then click Add Event Source.
In the Add Custom Event Source panel, configure the Name and Description parameters, select Custom Application from the Event Provider drop-down list, and then click OK.

Step 2: Create an event rule

Important

The event targets that you want to configure for an event rule must reside in the same region as the event rule.

Log on to the EventBridge console.
In the left-side navigation pane, click Event Buses.
In the top navigation bar, select a region.
On the Event Buses page, click the name of the event bus that you want to manage.
In the left-side navigation pane, click Event Rules.
In the left-side navigation pane, click Event Rules. On the page that appears, click Create Rule.
In the Create Rule wizard, perform the following steps:
1. In the Configure Basic Info step, enter a rule name in the Name field and a rule description in the Description field. Then, click Next Step.
2. In the Configure Event Pattern step, set the Event Source Type parameter to Custom Event Source and select the custom event source that you created in Step 1 from the Event Source drop-down list. In the Pattern Content code editor, specify an event pattern and click Next Step.
3. In the Configure Targets step, configure an event target. Then, click Create.
  Note
  You can configure up to five event targets for an event rule.
  - Service Type: Select SMQ.
  - Queue: Select the queue that you created.
  - Message Body: Select Complete Event.

Step 3: Publish an event

Log on to the EventBridge console. In the left-side navigation pane, click Event Buses.
In the top navigation bar, select a region.
On the Event Buses page, find the event bus to which you want to publish an event and click Publish Event in the Operations column.
Note You can publish events only to custom event buses in the EventBridge console.
In the Publish Event to Custom Event Bus panel, select a custom event source from the Custom Event Source drop-down list, enter the event content in the Event Body code editor, and then click OK.
For more information about the event parameters, see Overview.

Step 4: Verify the result

Log on to the SMQ console.
In the left-side navigation pane, choose Queue Model > Queues.
In the top navigation bar, select a region.
On the Queues page, find the queue to which you routed the events and choose More > Send Messages in the Actions column.

In the Receive Message section of the Quick Experience page, click Receive Message.

The following sample code provides an example of received events:

{
    "id": "45ef4dewdwe1-7c35-447a-bd93-fab****",
    "source": "acs.ecs",
    "specversion": "1.0",
    "subject": "acs.ecs:cn-hangzhou:123456789098****:215672",
    "time": "2020-11-19T21:04:41Z",
    "type": "ecs:Snapshot:CreateSnapshotCompleted",
    "aliyunaccountid": "123456789098****",
    "aliyunpublishtime": "2020-11-19T21:04:42Z",
    "aliyuneventbusname": "default",
    "aliyunregionid": "cn-hangzhou",
    "aliyunpublishaddr": "172.25.XX.XX",
    "data": {
        "result": "accomplished",
        "snapshotId": "s-bp151qed0khxxxxxxxxx",
        "snapshotType": "user",
        "snapshotName": "cust51119970_xxxxxxxx_20211117114015",
        "diskId": "d-bp18dnj7u1xxxxxxxxx",
        "startTime": "2020-11-19T21:02:16Z",
        "endTime": "2020-11-19T21:04:17Z"
    }
}

Step 5: Delete the event rule

Log on to the EventBridge console.
In the left-side navigation pane, click Event Buses.
In the top navigation bar, select a region.
On the Event Buses page, click the name of the target event bus.
In the left-side navigation pane, click Event Rules.
On the Event Rules page, find the rule that you want to delete and click Delete in the Operations column.
In the Note message, click OK.
In the Verify Account Security dialog box, click Obtain Verification Code, enter the verification code in the Verification Code field, and then click OK.

Step 6: Delete the custom event bus

Log on to the EventBridge console.
In the left-side navigation pane, click Event Buses.
In the top navigation bar, select a region.
On the Event Bus page, find the custom event bus that you want to delete and click Delete in the Operations column.
In the Note message, click OK.
(Optional) In the Verify Account Security dialog box, click Obtain Verification Code, enter the verification code in the Verification Code field, and then click OK.

Important

Make sure that no event source is associated with the custom event bus that you want to delete. Otherwise, the custom event bus fails to be deleted, and the following error message is returned: An event source has been bound to the event bus. Delete the event source bound to the event bus or specify another event bus.