AWS Clean Rooms イベントルーティング AWS Clean Rooms イベント

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 サービスは EventBridge のデフォルトのイベントバスにイベントを送信します。イベントがルールのイベントパターンに一致すると、EventBridge は、そのルールで指定されたターゲットに、イベントを送信します。

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

AWS Clean Rooms イベント

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

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

イベントの詳細のタイプ	説明
作成された分析テンプレート	分析テンプレートの作成時に、分析テンプレートの所有者とコラボレーションのすべてのアクティブなメンバーに通知されます。
分析テンプレートが更新されました	分析テンプレートの所有者と、更新を確認できるコラボレーションのすべてのアクティブなメンバーは、分析テンプレートが更新されると通知されます。
削除された分析テンプレート	分析テンプレートの所有者とコラボレーションのすべてのアクティブなメンバーは、分析テンプレートが削除されると通知されます。
作成されたコラボレーション	コラボレーションの作成時にコラボレーション所有者に通知されます。
コラボレーションの更新	コラボレーション所有者と、コラボレーションの更新を可視化できるコラボレーションのすべてのアクティブなメンバーは、コラボレーションが更新されると通知されます。
作成されたコラボレーション変更リクエスト	コラボレーション変更リクエストが作成されると、コラボレーション所有者とコラボレーションのすべてのアクティブなメンバーに通知されます。
コラボレーション変更リクエストが承認されました	コラボレーション変更リクエストが承認されると、コラボレーション所有者とコラボレーションのすべてのアクティブなメンバーに通知されます。
コラボレーション変更リクエストがキャンセルされました	コラボレーション変更リクエストがキャンセルされると、コラボレーション所有者とコラボレーションのすべてのアクティブなメンバーに通知されます。
コラボレーション変更リクエストのコミット	コラボレーション変更リクエストがコミットされると、コラボレーション所有者とコラボレーションのすべてのアクティブなメンバーに通知されます。
設定済みテーブルの関連付けが作成されました	設定済みテーブルの関連付けの所有者とコラボレーションのすべてのアクティブなメンバーは、設定済みテーブルの関連付けが作成されると通知されます。
設定済みテーブルの関連付けが更新されました	設定済みテーブルの関連付けの所有者と、更新を確認できるコラボレーションのすべてのアクティブなメンバーは、設定済みテーブルの関連付けが更新されると通知されます。
設定済みテーブルの関連付けが削除されました	設定済みテーブルの関連付けの所有者とコラボレーションのすべてのアクティブなメンバーは、設定済みテーブルの関連付けが削除されると通知されます。
設定済みテーブルの関連付け分析ルールが作成されました	設定済みテーブル関連付け分析ルールの所有者とコラボレーションのすべてのアクティブなメンバーは、設定済みテーブル関連付け分析ルールが作成されると通知されます。
設定済みテーブルの関連付け分析ルールが更新されました	設定済みテーブルの関連付け分析ルールの所有者と、更新を確認できるコラボレーションのすべてのアクティブなメンバーは、設定済みテーブルの関連付け分析ルールが更新されると通知されます。
設定済みテーブルの関連付け分析ルールが削除されました	設定済みテーブル関連付け分析ルールの所有者とコラボレーションのすべてのアクティブなメンバーは、設定済みテーブル関連付け分析ルールが削除されると通知されます。
ID マッピングテーブルが作成されました	ID マッピングテーブルの所有者とコラボレーションのすべてのアクティブなメンバーは、ID マッピングテーブルが作成されると通知されます。
ID マッピングテーブルが更新されました	ID マッピングテーブルの所有者と、更新を確認できるコラボレーションのすべてのアクティブなメンバーは、ID マッピングテーブルが更新されると通知されます。
ID マッピングテーブルが削除されました	ID マッピングテーブルの所有者とコラボレーションのすべてのアクティブなメンバーは、ID マッピングテーブルが削除されると通知されます。
ID 名前空間の関連付けが作成されました	ID 名前空間関連付けの所有者とコラボレーションのすべてのアクティブなメンバーは、ID 名前空間関連付けが作成されると通知されます。
ID 名前空間の関連付けが更新されました	ID 名前空間関連付けの所有者と、更新を確認できるコラボレーションのすべてのアクティブなメンバーは、ID 名前空間関連付けが更新されると通知されます。
ID 名前空間の関連付けが削除されました	ID 名前空間関連付けの所有者とコラボレーションのすべてのアクティブなメンバーは、ID 名前空間関連付けが削除されると通知されます。
コラボレーションに招待されました	招待されたメンバーは、コラボレーションに招待されると通知されます。
作成されたメンバーシップ	メンバーシップの作成時に、メンバーシップ所有者とコラボレーションのすべてのアクティブなメンバーに通知されます。
メンバーシップの更新	メンバーシップが更新されると、メンバーシップ所有者に通知されます。ただし、メンバーシップがコラボレーションから削除された場合は、コラボレーションのすべてのアクティブなメンバーに通知されます。
削除されたメンバーシップ	メンバーシップが削除されると、メンバーシップ所有者とコラボレーションのすべてのアクティブなメンバーに通知されます。
保護されたジョブが送信されました	保護対象ジョブの送信時に、保護対象ジョブのジョブランナー、ジョブ支払者、結果レシーバーに通知されます。
保護ジョブが開始されました	保護対象ジョブのジョブランナー、ジョブ支払者、結果レシーバーは、保護対象ジョブの開始時に通知されます。
保護されたジョブのキャンセル	保護されたジョブのジョブランナー、ジョブ支払者、結果レシーバーは、保護されたジョブがキャンセルされると通知されます。
保護されたジョブがキャンセルされました	保護対象ジョブのジョブランナー、ジョブ支払者、結果レシーバーは、保護対象ジョブがキャンセルされると通知されます。
保護されたジョブが成功しました	保護対象ジョブのジョブランナー、ジョブ支払者、結果レシーバーは、保護対象ジョブが成功すると通知されます。
保護ジョブが失敗しました	保護対象ジョブのジョブランナー、ジョブ支払者、結果レシーバーは、保護対象ジョブが失敗すると通知されます。
保護されたクエリが送信されました	保護されたクエリのクエリランナー、クエリ支払者、結果レシーバー (複数可) は、保護されたクエリが送信されると通知されます。
保護されたクエリが開始されました	保護されたクエリのクエリランナー、クエリ支払者、結果レシーバー (複数可) は、保護されたクエリが開始されると通知されます。
保護されたクエリのキャンセル	保護されたクエリのクエリランナー、クエリ支払者、結果レシーバー (複数可) は、保護されたクエリがキャンセルされると通知されます。
保護されたクエリがキャンセルされました	保護されたクエリのクエリランナー、クエリ支払者、結果レシーバー (複数可) は、保護されたクエリがキャンセルされると通知されます。
保護されたクエリが成功しました	保護されたクエリのクエリランナー、クエリ支払者、結果レシーバー (複数可) は、保護されたクエリが成功すると通知されます。
保護されたクエリが失敗しました	保護されたクエリのクエリランナー、クエリ支払者、結果レシーバー (複数可) は、保護されたクエリが失敗すると通知されます。
保護されたクエリがタイムアウトしました	保護されたクエリのクエリランナー、クエリ支払者、結果レシーバー (複数可) は、保護されたクエリがタイムアウトすると通知されます。

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 属性。

たとえば、次のイベントパターンは、コラボレーションが削除されたすべての Id 名前空間関連付けの更新済みイベントと一致します AWS Clean Rooms。


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

イベントパターンの記述の詳細については、「EventBridge ユーザーガイド」の「Event patterns」を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

CloudTrail ログ

イベントの詳細リファレンス