您可以通過事件規則過濾事件,將事件路由到API端點,本文以自定義事件為例介紹將事件路由到API端點的前提條件、操作步驟和結果驗證。
前提條件
步驟一:添加自定義事件源
- 登錄事件總線EventBridge控制臺,在左側導航欄,單擊事件總線。
- 在頂部菜單欄,選擇地域,在事件總線頁面,單擊目標自定義事件總線名稱。
- 在左側導航欄,單擊事件源,然后單擊添加事件源。
在添加自定義事件源面板,輸入名稱和描述,事件提供方選擇自定義應用,然后單擊確定。
步驟二:創建事件規則
目標服務和事件規則必須處于同一地域。
- 登錄事件總線EventBridge控制臺,在左側導航欄,單擊事件總線。
- 在頂部菜單欄,選擇地域,在事件總線頁面,單擊目標總線名稱。
- 在左側導航欄,單擊事件規則,然后單擊創建規則。
在創建規則面板,完成以下操作,然后單擊創建。
在配置基本信息頁簽,自定義規則名稱和規則描述。
在配置事件模式頁簽,選擇事件源類型為自定義事件源,并選擇已創建的事件源,然后單擊下一步。
在配置事件目標頁簽,配置一下信息,然后單擊創建。
選擇服務類型為API觸發。
按照下表說明配置基礎信息區域的信息。
配置參數
示例
說明
創建方式
自定義創建
支持以下兩種方式:
自定義創建:如果您選用此種方式,需要在當前頁面創建API端點。
使用已有:如果您選擇此種方式,需要您提前創建好API端點。具體操作,請參見創建API端點。
API 目標名稱
testAPI
自定義API端點名稱。
描述
無
自定義描述信息,非必填項。
HTTP 參數
Parameter:Header
Key:
Content-Type
Value:
multipart/form-data
Parameter支持以下三種配置方式:
Header:此方式是通過請求頭傳遞元信息。這種方式只能以鍵值對的形式進行配置。
Body:此方式是通過請求體傳遞實際數據。這種方式支持鍵值對或原始數據兩種方式進行配置。
Query:此方式是通過URL查詢字符串傳遞參數。這種方式只能以鍵值對的形式進行配置。
三種Parameter配置的具體方式如下所示:
鍵值對:Key支持部分事件、固定值或完整事件,Value同樣支持部分事件、固定值或完整事件。
原始數據:需要配置變量和模板。具體配置信息,請參見模板。
在API 配置區域設置以下信息。
配置項
示例
說明
URL
https://******
此URL為需要訪問服務端資源的API地址。
HTTP Method
GET
支持以下請求方式獲取服務端資源:
GET:請求指定的頁面信息,并返回實體主體。
POST:向指定資源提交數據,請求服務器進行處理。數據被包含在請求體中。
PUT:向指定資源位置上傳其最新內容。
PATCH:用于對資源進行部分修改。
DELETE:請求服務器刪除指定的資源。
HEAD:類似于GET請求,但服務器只返回狀態行和頭部信息,不返回消息體。
在連接配置區域設置以下信息。
配置項
示例
說明
配置方式
新建配置
支持以下兩種配置方式:
新建配置:如果您選擇此種方式,需要在當前頁面創建Connection。
選擇已有:如果選擇此種方式,需要您提前創建好Connection。具體操作,請參見創建Connection。
連接名稱
Connection-test
自定義Connection名稱。
連接描述
無
自定義描述信息,非必填項。
鑒權配置
無需配置
支持以下四種鑒權配置:
無需配置:如果您選擇此種方式,表示任何訪問請求都會被API端點響應。
Basic:此種方式為基本身份驗證方式,如果您選擇此種方式,需要您自定義用于授權用戶名和密碼。
OAuth 客戶端憑據:此種方式是一種更加安全可靠的授權認證方式。
API Key:此種方式是一種比較簡單的認證方式。如果選擇此種方式,需要您自定義API訪問的KeyName和KeyValue。
網絡選擇
公網
有以下兩種網絡類型可以選擇:
(可選):展開重試和死信區域,配置重試策略、容錯策略和死信隊列。具體配置信息,請參見重試和死信。
步驟三:發布事件
- 登錄事件總線EventBridge控制臺,在左側導航欄,單擊事件總線。
- 在頂部菜單欄,選擇地域。
在事件總線頁面,找到目標總線,在其右側操作列單擊發布事件。
說明僅自定義事件總線支持通過控制臺發布事件。
在發布事件至自定義事件總線面板,自定義事件源下拉列表選擇已創建的自定義事件源,在事件體代碼框輸入事件內容,然后單擊確定。
說明事件包含的參數規范,請參見事件概述。
單擊確定后,會默認復制事件ID。
結果驗證
進入目標事件總線的概覽頁面。
在左側導航欄單擊事件追蹤,然后單擊按時間ID查詢頁簽。
在事件ID對應的文本框中復制事件ID,然后單擊查詢。
單擊目標事件操作列的事件軌跡,查看事件是否投遞成功。