使用 Amazon EventBridge 整合 AWS Clean Rooms 到事件驅動型應用程式

您可以將 AWS Clean Rooms 納入使用 中發生的事件的事件驅動應用程式 (EDAs)， AWS Clean Rooms 以在應用程式元件之間通訊並啟動下游程序。您可以使用 Amazon EventBridge 將事件從 路由 AWS Clean Rooms 到其他軟體元件來執行此操作。Amazon EventBridge 是一種無伺服器服務，使用事件將應用程式元件連接在一起，讓您更輕鬆地將 等 AWS AWS Clean Rooms 服務整合到事件驅動型架構中，而無需額外的程式碼和操作。

事件驅動架構是一種建置鬆耦合軟體系統的方式，透過發出和回應事件來協作。在此模型中，事件代表資源或環境中的變更。

以下是 EventBridge 的使用方式 AWS Clean Rooms：

如同許多 AWS 服務， AWS Clean Rooms 會產生事件並將其傳送至 EventBridge 預設事件匯流排。事件匯流排是接收事件並將其路由到您指定的目的地或目標的路由器。目標可以包含其他服務 AWS 、自訂應用程式和 SaaS 合作夥伴應用程式。

EventBridge 會根據您在事件匯流排上建立的規則路由事件。對於每個規則，您可以指定篩選條件或事件模式，以僅選取您想要的事件。每當事件傳送到事件匯流排時，EventBridge 都會將其與每個規則進行比較。如果事件符合規則，EventBridge 會將事件路由到指定的目標 (s)。

例如，假設您每次在帳戶中建立新的 AWS Clean Rooms 協同合作時，都想知道 。您可以在預設事件匯流排上建立規則。在規則中，您會建立事件模式，從名為 的 AWS Clean Rooms 指定事件Collaboration Created。每次 EventBridge 收到符合這些屬性的事件時，都會將該事件路由到指定的工作流程。

AWS Clean Rooms 事件

AWS 服務可以直接將事件傳送到 EventBridge 預設事件匯流排。此外， 也會 AWS CloudTrail 將來自許多 AWS 服務的事件傳送至 EventBridge。這些事件可能包括 API 呼叫、主控台登入和動作、服務事件和 CloudTrail Insights。如需詳細資訊，請參閱EventBridge 使用者指南》中的AWS 透過 傳遞的服務事件 AWS CloudTrail。

如需傳送至 EventBridge 的完整 AWS Clean Rooms 事件清單，請參閱 EventBridge 事件參考中的 AWS Clean Rooms 主題。

事件詳細資訊類型	描述
協同合作已建立	協同合作已建立
協同合作已更新	協同合作已更新
成員資格已建立	成員資格已建立
成員資格已更新	成員資格已更新
已刪除成員資格	已刪除成員資格
已提交受保護的查詢	已提交受保護的查詢
受保護查詢成功	受保護查詢成功
受保護的查詢失敗	受保護的查詢失敗
受保護的查詢逾時	受保護的查詢逾時
已提交受保護的任務	已提交受保護的任務
受保護任務成功	受保護任務成功
受保護的任務失敗	受保護的任務失敗
已取消受保護的任務	已取消受保護的任務

使用 EventBridge 路由 AWS Clean Rooms 事件

若要讓 EventBridge 將 AWS Clean Rooms 事件路由到目標，您必須建立規則。每個規則都包含事件模式，EventBridge 會比對事件匯流排上收到的每個事件。如果事件資料符合指定的事件模式，EventBridge 會將該事件路由到規則的目標 (s)。

如需建立事件匯流排規則的完整說明，請參閱EventBridge 使用者指南》中的建立對事件做出反應的規則。

建立符合事件 AWS Clean Rooms 的事件模式

每個事件模式都是 JSON 物件，其中包含：

• （選用）：識別服務傳送事件的source屬性。對於 AWS Clean Rooms 事件，來源為 aws.cleanrooms。

• （選用）：包含要比對之事件名稱陣列的detail-type屬性。

• (選擇性)：包含要比對的任何其他事件資料的 detail 屬性。

例如，下列事件模式符合從中刪除協同合作的所有成員資格更新事件 AWS Clean Rooms：

{
  "source": ["aws.cleanrooms"],
  "detail-type": ["Membership Updated"],
  "detail": {
    "status": ["COLLABORATION_DELETED"]
  }
}

如需撰寫事件模式的詳細資訊，請參閱 EventBridge 使用者指南中的事件模式。