DataWorks：開啟訊息訂閱

步驟一：服務授權

初次使用OpenEvent服務，請使用主帳號或擁有AliyunDataWorksFullAccess許可權的RAM帳號，參考以下步驟，實現DataWorks可訪問EventBridge服務。

1. 進入開放平台頁面。

   登入DataWorks控制台，切換至目標地區後，單擊左側導覽列的更多 > 開放平台，進入開放平台的開發人員後台頁面。

2. 進入OpenEvent頁面。

   在開放平台的開發人員後台頁面，單擊左側導覽列中的OpenEvent，進入OpenEvent頁面。

3. 授權DataWorks訪問EventBridge資源。

   若您是首次使用，則會出現單擊授權按鈕，您需根據介面指引授權DataWorks訪問EventBridge資源，授權後將自動在RAM存取控制的身份管理 > 角色中建立一個服務關聯角色AliyunServiceRoleForDataWorksOpenPlatform。關於該RAM角色的相關說明，詳情請參見附錄：DataWorks服務關聯角色。

步驟二：配置事件分發通道

事件分發通道能將DataWorks空間與EventBridge事件匯流排映射起來，即是通過事件分發通道指定DataWorks某工作空間下所有已開放的訊息推送至EventBridge某事件匯流排。

1. 進入OpenEvent頁面。

   在開放平台的開發人員後台頁面，單擊左側導覽列中的OpenEvent，進入OpenEvent頁面。

2. 配置事件分發通道。

   單擊添加事件分發通道按鈕，會出現添加事件分發通道的彈窗，在彈窗內配置需要分發事件的工作空間和指定分發到EventBridge中自訂匯流排。

   說明

   • 若您在EventBridge內無可用的事件匯流排，也可以通過直接單擊建立自訂事件匯流排，跳轉至事件匯流排EventBridge建立自訂事件匯流排或單擊快捷建立與工作空間同名的自訂匯流排快速建置事件匯流排。

   • 租戶層級模組操作產生的訊息將自動推送至EventBridge內建的事件匯流排Default中，若要接收租戶級模組產生的事件訊息，您可跳過此步驟。

   

步驟三：開啟事件分發通道

事件分發通道配置完成後，可在OpenEvent的頁面內查看建立的分發通道。在其操作列，可對分發通道執行刪除、啟用、禁用操作。

• 啟用：啟用該事件分發通道後，該工作空間的事件訊息將會推送至EventBridge中對應的事件匯流排。

  可通過EventBridge控制台查看DataWorks推送至EventBridge的所有事件訊息，篩選出最終目標端需要消費的訊息，並定義這些訊息最終發送到哪些服務以及如何消費。

• 禁用：禁用該事件分發通道後，該工作空間的事件訊息將停止向EventBridge中對應的事件匯流排推送，您將無法通過EventBridge接收到相應的事件訊息。

• 刪除：刪除該事件分發通道後，該工作空間的事件訊息將停止向EventBridge中對應的事件匯流排推送，您將無法通過EventBridge接收到相應的事件訊息。

單擊啟用後，事件分發通道將處於啟用狀態，通過該通道分發到事件匯流排的訊息會按照規則推送至配置的事件目標中。

步驟一：建立自訂事件匯流排（可選）

若在步驟二：配置事件分發通道建立的與DataWorks工作空間同名的自訂匯流排，直接使用該事件匯流排，若是單擊建立自訂匯流排，可按照以下步驟自訂匯流排。EventBridge詳情請參見事件匯流排概述。

1. 進入EventBridge控制台後，單擊左側導覽列內事件匯流排跳轉至事件匯流排頁面。

2. 進入事件匯流排後，在自訂事件匯流排內單擊快速建立，建立事件匯流排。以下為手動建立自訂事件匯流排DataWorks2023。

   

步驟二：配置事件規則

建立好事件匯流排後，可手動為事件匯流排配置事件規則實現將DataWorks的事件訊息推送至相應服務中。

1. 進入EventBridge控制台。

2. 配置事件規則。

   在左側導覽列單擊事件匯流排，找到需要配置資料過濾與指定路由服務的EventBridge事件匯流排，單擊操作 > 事件規則進入事件規則配置頁面。

   配置基本資料

   在事件規則頁面單擊左上方的建立規則按鈕，進行事件規則的建立。

   • 名稱：為規則進行命名即可。

   • 描述：對該規則進行簡單描述

   配置事件模式

   1. 通過模式內容過濾事件訊息，按照以下範例進行配置：

      • 事件來源類型：選擇自訂事件來源。

      • 事件來源：保持預設。

      • 模式內容：利用JSON來進行配置相應的事件訊息類型，DataWorks每個事件訊息都有固定的訊息類型，您可通過開發參考：事件列表與訊息格式查看擷取DataWorks各類操作對應的訊息類型，並作為模式內容的type鍵的值進行配置。

        {
            "source": [
                "acs.dataworks"
            ],
            "type": [
                "dataworks:InstanceStatusChanges:InstanceStatusChanges"
            ]
        }

        

   2. 完成事件模式配置後，可通過事件模式調實驗證模式內容是否符合預期。

      若已完成DataWorks側的步驟三：開啟事件分發通道，此時的DataWorks事件訊息已經可正常發送至EventBridge，您可在EventBridge事件追蹤頁面，查詢該事件匯流排中DataWorks的所有事件，在操作列單擊某一事件詳情，複製事件詳情資訊，填寫至事件模式調試中單擊測試查看過濾是否生效。

      • 當事件類型不一致時，進行測試會出現匹配失敗字樣。

        

      • 當事件類型一致時，進行測試會出現匹配通過，事件可正常被觸發字樣

        

   配置事件目標

   事件目標除了可以推送至自建服務外，還可以推送至更多目標，用於消費事件，詳情請參考事件目標概述。

   

   說明

   按圖示上的配置是將訊息推送至指定的HTTPS服務，若希望擴充程式接收此訊息，您可以選擇服務類型為HTTPS，並在URL配置為擴充程式部署地址即可

3. 完成並儲存事件規則配置後，即可通過事件匯流排EventBridge實現對DataWorks事件訊息的分發路由，以及為後續的擴充程式（Extensions）提供了支援。