Amazon EventBridge を使用してイベント駆動型アプリケーション AWS Clean Rooms に統合する

で発生するイベントを使用してアプリケーションコンポーネント間で通信し、ダウンストリームプロセスを開始するイベント駆動型アプリケーション (EDAs) AWS Clean Rooms 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 は指定されたターゲット (複数可) にイベントをルーティングします。

例えば、アカウントで新しい AWS Clean Rooms コラボレーションが作成されるたびに知りたいとします。デフォルトのイベントバスにルールを作成できます。ルールでは、 という名前の AWS クリーンルームからのイベントを指定するイベントパターンを作成しますCollaboration Created。EventBridge は、これらのプロパティに一致するイベントを受信するたびに、指定されたワークフローにイベントをルーティングします。

AWS Clean Rooms イベント

AWS サービスは、EventBridge のデフォルトイベントバスに直接イベントを送信できます。さらに、 AWS CloudTrail は多数の AWS サービスから発生したイベントも EventBridge に送信します。これらのイベントには、API コール、コンソールのサインインとアクション、サービスイベント、CloudTrail Insights などがあります。詳細については、EventBridge ユーザーガイド」の「 AWS 経由で配信されるサービスイベント AWS CloudTrail」を参照してください。

EventBridge に送信される AWS Clean Rooms イベントの完全なリストについては、EventBridge Events Reference」の AWS Clean Rooms 「」トピックを参照してください。

イベントの詳細のタイプ	説明
作成されたコラボレーション	作成されたコラボレーション
コラボレーションの更新	コラボレーションの更新
作成されたメンバーシップ	作成されたメンバーシップ
メンバーシップの更新	更新されたメンバーシップ
削除されたメンバーシップ	削除されたメンバーシップ
保護されたクエリが送信されました	保護されたクエリが送信されました
保護されたクエリが成功しました	保護されたクエリが成功しました
保護されたクエリが失敗しました	保護されたクエリが失敗しました
保護されたクエリがタイムアウトしました	保護されたクエリがタイムアウトしました
保護されたジョブが送信されました	保護されたジョブが送信されました
保護されたジョブが成功しました	保護されたジョブが成功しました
保護されたジョブが失敗しました	保護されたジョブが失敗しました
保護されたジョブがキャンセルされました	保護されたジョブがキャンセルされました

EventBridge を使用した AWS Clean Rooms イベントのルーティング

EventBridge で AWS Clean Rooms イベントをターゲットにルーティングするには、ルールを作成する必要があります。各ルールにはイベントパターンが含まれており、EventBridge はイベントバスで受信した各イベントと照合します。イベントデータが指定されたイベントパターンと一致する場合、EventBridge はそのイベントをルールのターゲット (複数可) にルーティングします。

イベントバスルールの詳細な作成方法については、「EventBridge ユーザーガイド」の「Creating rules that react to events」を参照してください。

イベントに一致する 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 ユーザーガイド」の「Event patterns」を参照してください。