事件概述
更新時間 2025-06-18 17:54:12
最近更新時間: 2025-06-18 17:54:12
分享文章
事件由事件源發出，是事件源狀態變化的數據記錄。本文介紹事件總線EventBridge的事件參數詳情。事件源發布事件到事件總線EventBridge，需遵循CloudEvents 1.0協議。
以下是事件源發布到事件總線EventBridge的示例事件：
{
"id":"b5771f76-****-48ed-b1ba-d15418c*****",
"source":"ctyun.oss",
"specversion":"1.0",
"type":"my.source:events",
"subject":"my.source:huadong1:{AccountId}:my-project:xxx",
"time":"2024-03-05T13:52:18.374Z",
"datacontenttype":"application/json;charset=utf-8",
"data":{
"key":"value",
"def":"xxxx"
},
"ctyunaccountid":"123456789****",
"ctyunresourceid":"27aadda4-****-11ee-a6fc-e8b47009****",
"ctyuneventbusname":"default",
"ctyunregion":"bb9fdb42056**********10002",
}事件中涉及的參數如下所示。
| 參數 | 類型 | 是否必選 | 示例值 | 說明 |
|---|---|---|---|---|
| id | String | 是 | b5771f76-****-48ed-b1ba-d15418c***** | 事件ID。標識事件的唯一值。發送端必須確保source+id是唯一的，如果由于網絡等原因事件被重新發送，可能會產生兩個相同id的事件。接收端會認為具有相同source和id的事件是重復的。事件通過規則路由到目標、事件被處理時，需要根據id跟蹤事件。 |
| source | String | 是 | ctyun.oss | 事件源唯一標識。提供事件的服務。標識事件發生的內容。一般會包含事件源的類型，發布事件的機制或生產事件的過程。發送端必須確保每個事件的source+id是唯一的。 |
| specversion | String | 是 | 1.0 | CloudEvents協議版本。 |
| type | String | 是 | oss:create-bucket | 事件類型。描述事件源相關的事件類型。該參數用于路由、事件查詢和策略執行等。格式由生產者定義，且包含版本等信息。 |
| subject | String | 否 | ctyun.oss:huadong1:{AccountId}:bucketname-xxx | 事件主體。在發布訂閱模式中，訂閱者通常訂閱source發出的事件，當source中包含子結構時，只使用source無法對具體事件進行清晰的定義，subject參數在訂閱過濾場景中對data無法解釋的內容提供說明。 |
| time | Timestamp | 否 | 2024-03-05T13:52:18.374Z | 事件產生的時間。如果無法確定事件發生的時間，事件生產者可以把time設置為其他時間（例如當前時間），但是同一個source的所有生產者設置的值必須是一致的。 |
| datacontenttype | String | 否 | application/json;charset=utf-8 | 參數data的內容形式。datacontenttype只支持application/json格式。 |
| data | Struct | 否 | { "abc":"1111", "def":"xxxx" } | 事件內容。JSON對象，內容由發起事件的服務決定。CloudEvents可能包含事件發生時由事件生產者給定的上下文，data中封裝了這些信息。 |
| ctyunaccountid | String | 否 | 123456789**** | 天翼云賬號ID，選填，不是CloudEvents1.0協議規定的必選字段。 |
| ctyunuserid | String | 否 | 123456789**** | 天翼云用戶ID，選填，不是CloudEvents1.0協議規定的必選字段。 |
| ctyunresourceid | String | 否 | 27aadda4-db94-11ee-a6fc-e8b47009**** | 天翼云資源ID，選填，不是CloudEvents1.0協議規定的必選字段。 |
| ctyuneventbusname | String | 是 | default | 接收事件的事件總線名稱，必填。如：官方產品專用總線為default，亦可填寫用戶創建的自定義總線名。 |
| ctyunregion | String | 否 | bb9fdb42056**********10002 | 接收事件的地域。如華東一為：bb9fdb42056**********10002，選填。 |
事件源發布到事件總線EventBridge的事件有以下兩種類型：
天翼云服務事件
天翼云服務作為事件源自動接入事件總線EventBridge，將事件投遞到總線名為default的官方總線。關于事件總線EventBridge支持的所有天翼云服務事件類型，請參見天翼云官方事件源概述。
自定義應用事件
您自己的應用作為事件源接入時，需要配置自己的應用使用SDK接入事件總線EventBridge，詳見SDK概述。
