翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon EventBridge を使用してイベント駆動型アプリケーション AWS Clean Rooms に統合する
<a name="eventbridge-integration-full"></a>

で発生するイベントを使用してアプリケーションコンポーネント間で通信し、ダウンストリームプロセスを開始するイベント駆動型アプリケーション (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 は、そのルールで指定されたターゲットに、イベントを送信します。](http://docs.aws.amazon.com/ja_jp/clean-rooms/latest/userguide/images/eventbridge-integration-how-it-works.png)


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

## AWS Clean Rooms イベント
<a name="eventbridge-service-events-full"></a>

AWS サービスは、EventBridge のデフォルトのイベントバスに直接イベントを送信できます。さらに、 AWS CloudTrail は多数の AWS サービスから発生したイベントも EventBridge に送信します。これらのイベントには、API コール、コンソールのサインインとアクション、サービスイベント、CloudTrail Insights などがあります。詳細については、「*Amazon EventBridge ユーザーガイド*」の「[AWS service events delivered via AWS CloudTrail](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event-cloudtrail.html)」を参照してください。

EventBridge に送信される AWS Clean Rooms イベントの完全なリストについては、[https://docs.aws.amazon.com/eventbridge/latest/ref/welcome.html](https://docs.aws.amazon.com/eventbridge/latest/ref/welcome.html)の AWS Clean Rooms トピックを参照してください。


| イベントの詳細のタイプ | 説明 | 
| --- | --- | 
| [作成された分析テンプレート](events-detail-reference-full.md#event-detail-analysis-template-created) | 分析テンプレートの作成時に、分析テンプレートの所有者とコラボレーションのすべてのアクティブなメンバーに通知されます。 | 
| [分析テンプレートが更新されました](events-detail-reference-full.md#event-detail-analysis-template-updated) | 分析テンプレートの所有者と、更新を確認できるコラボレーションのすべてのアクティブなメンバーは、分析テンプレートが更新されると通知されます。 | 
| [削除された分析テンプレート](events-detail-reference-full.md#event-detail-analysis-template-deleted) | 分析テンプレートの所有者とコラボレーションのすべてのアクティブなメンバーは、分析テンプレートが削除されると通知されます。 | 
| [作成されたコラボレーション](events-detail-reference-full.md#event-detail-collaboration-created) | **コラボレーション****の作成**時に**コラボレーション**所有者に通知されます。 | 
| [コラボレーションの更新](events-detail-reference-full.md#event-detail-collaboration-updated) | **コラボレーション**所有者と、コラボレーションの更新を可視化できるコラボレーションのすべてのアクティブなメンバーは、**コラボレーション****が更新され**ると通知されます。 | 
| [作成されたコラボレーション変更リクエスト](events-detail-reference-full.md#event-detail-collaboration-change-request-created) | コラボレーション変更リクエストが作成されると、コラボレーション所有者とコラボレーションのすべてのアクティブなメンバーに通知されます。 | 
| [コラボレーション変更リクエストが承認されました](events-detail-reference-full.md#event-detail-collaboration-change-request-approved) | コラボレーション変更リクエストが承認されると、コラボレーション所有者とコラボレーションのすべてのアクティブなメンバーに通知されます。 | 
| [コラボレーション変更リクエストがキャンセルされました](events-detail-reference-full.md#event-detail-collaboration-change-request-cancelled) | コラボレーション変更リクエストがキャンセルされると、コラボレーション所有者とコラボレーションのすべてのアクティブなメンバーに通知されます。 | 
| [コラボレーション変更リクエストのコミット](events-detail-reference-full.md#event-detail-collaboration-change-request-committed) | コラボレーション変更リクエストがコミットされると、コラボレーション所有者とコラボレーションのすべてのアクティブなメンバーに通知されます。 | 
| [設定済みテーブルの関連付けが作成されました](events-detail-reference-full.md#event-detail-configured-table-association-created) | 設定済みテーブルの関連付けの所有者とコラボレーションのすべてのアクティブなメンバーは、設定済みテーブルの関連付けが作成されると通知されます。 | 
| [設定済みテーブルの関連付けが更新されました](events-detail-reference-full.md#event-detail-configured-table-association-updated) | 設定済みテーブルの関連付けの所有者と、更新を確認できるコラボレーションのすべてのアクティブなメンバーは、設定済みテーブルの関連付けが更新されると通知されます。 | 
| [設定済みテーブルの関連付けが削除されました](events-detail-reference-full.md#event-detail-configured-table-association-deleted) | 設定済みテーブルの関連付けの所有者とコラボレーションのすべてのアクティブなメンバーは、設定済みテーブルの関連付けが削除されると通知されます。 | 
| [設定済みテーブルの関連付け分析ルールが作成されました](events-detail-reference-full.md#event-detail-configured-table-association-analysis-rule-created) | 設定済みテーブル関連付け分析ルールの所有者とコラボレーションのすべてのアクティブなメンバーは、設定済みテーブル関連付け分析ルールが作成されると通知されます。 | 
| [設定済みテーブルの関連付け分析ルールが更新されました](events-detail-reference-full.md#event-detail-configured-table-association-analysis-rule-updated) | 設定済みテーブルの関連付け分析ルールの所有者と、更新を確認できるコラボレーションのすべてのアクティブなメンバーは、設定済みテーブルの関連付け分析ルールが更新されると通知されます。 | 
| [設定済みテーブルの関連付け分析ルールが削除されました](events-detail-reference-full.md#event-detail-configured-table-association-analysis-rule-deleted) | 設定済みテーブル関連付け分析ルールの所有者とコラボレーションのすべてのアクティブなメンバーは、設定済みテーブル関連付け分析ルールが削除されると通知されます。 | 
| [ID マッピングテーブルが作成されました](events-detail-reference-full.md#event-detail-id-mapping-table-created) | ID マッピングテーブルの所有者とコラボレーションのすべてのアクティブなメンバーは、ID マッピングテーブルが作成されると通知されます。 | 
| [ID マッピングテーブルが更新されました](events-detail-reference-full.md#event-detail-id-mapping-table-updated) | ID マッピングテーブルの所有者と、更新を確認できるコラボレーションのすべてのアクティブなメンバーは、ID マッピングテーブルが更新されると通知されます。 | 
| [ID マッピングテーブルが削除されました](events-detail-reference-full.md#event-detail-id-mapping-table-deleted) | ID マッピングテーブルの所有者とコラボレーションのすべてのアクティブなメンバーは、ID マッピングテーブルが削除されると通知されます。 | 
| [ID 名前空間の関連付けが作成されました](events-detail-reference-full.md#event-detail-id-namespace-association-created) | ID 名前空間関連付けの所有者とコラボレーションのすべてのアクティブなメンバーは、ID 名前空間関連付けが作成されると通知されます。 | 
| [ID 名前空間の関連付けが更新されました](events-detail-reference-full.md#event-detail-id-namespace-association-updated) | ID 名前空間関連付けの所有者と、更新を確認できるコラボレーションのすべてのアクティブなメンバーは、ID 名前空間関連付けが更新されると通知されます。 | 
| [ID 名前空間の関連付けが削除されました](events-detail-reference-full.md#event-detail-id-namespace-association-deleted) | ID 名前空間関連付けの所有者とコラボレーションのすべてのアクティブなメンバーは、ID 名前空間関連付けが削除されると通知されます。 | 
| [コラボレーションに招待されました](events-detail-reference-full.md#event-detail-invited-to-collaboration) | 招待されたメンバーは、コラボレーションに招待されると通知されます。 | 
| [作成されたメンバーシップ](events-detail-reference-full.md#event-detail-membership-created) | メンバーシップの作成時に、メンバーシップ所有者とコラボレーションのすべてのアクティブなメンバーに通知されます。 | 
| [メンバーシップの更新](events-detail-reference-full.md#event-detail-membership-updated) | メンバーシップが更新されると、メンバーシップ所有者に通知されます。ただし、メンバーシップがコラボレーションから削除された場合は、コラボレーションのすべてのアクティブなメンバーに通知されます。 | 
| [削除されたメンバーシップ](events-detail-reference-full.md#event-detail-membership-deleted) | メンバーシップが削除されると、メンバーシップ所有者とコラボレーションのすべてのアクティブなメンバーに通知されます。 | 
| [保護されたジョブが送信されました](events-detail-reference-full.md#event-detail-protected-job-submitted) | 保護対象ジョブの送信時に、保護対象ジョブのジョブランナー、ジョブ支払者、結果レシーバーに通知されます。  | 
| [保護ジョブが開始されました](events-detail-reference-full.md#event-detail-protected-job-started) | 保護対象ジョブのジョブランナー、ジョブ支払者、結果レシーバーは、保護対象ジョブの開始時に通知されます。 | 
| [保護されたジョブのキャンセル](events-detail-reference-full.md#event-detail-protected-job-cancelling) | 保護されたジョブのジョブランナー、ジョブ支払者、結果レシーバーは、保護されたジョブがキャンセルされると通知されます。 | 
| [保護されたジョブがキャンセルされました](events-detail-reference-full.md#event-detail-protected-job-cancelled) | 保護対象ジョブのジョブランナー、ジョブ支払者、結果レシーバーは、保護対象ジョブがキャンセルされると通知されます。 | 
| [保護されたジョブが成功しました](events-detail-reference-full.md#event-detail-protected-job-succeeded) | 保護対象ジョブのジョブランナー、ジョブ支払者、結果レシーバーは、保護対象ジョブが成功すると通知されます。 | 
| [保護ジョブが失敗しました](events-detail-reference-full.md#event-detail-protected-job-failed) | 保護対象ジョブのジョブランナー、ジョブ支払者、結果レシーバーは、保護対象ジョブが失敗すると通知されます。 | 
| [保護されたクエリが送信されました](events-detail-reference-full.md#event-detail-protected-query-submitted) | 保護されたクエリのクエリランナー、クエリ支払者、結果レシーバー (複数可) は、保護されたクエリが送信されると通知されます。 | 
| [保護されたクエリが開始されました](events-detail-reference-full.md#event-detail-protected-query-started) | 保護されたクエリのクエリランナー、クエリ支払者、結果レシーバー (複数可) は、保護されたクエリが開始されると通知されます。 | 
| [保護されたクエリのキャンセル](events-detail-reference-full.md#event-detail-protected-query-cancelling) | 保護されたクエリのクエリランナー、クエリ支払者、結果レシーバー (複数可) は、保護されたクエリがキャンセルされると通知されます。 | 
| [保護されたクエリがキャンセルされました](events-detail-reference-full.md#event-detail-protected-query-cancelled) | 保護されたクエリのクエリランナー、クエリ支払者、結果レシーバー (複数可) は、保護されたクエリがキャンセルされると通知されます。 | 
| [保護されたクエリが成功しました](events-detail-reference-full.md#event-detail-protected-query-succeeded) | 保護されたクエリのクエリランナー、クエリ支払者、結果レシーバー (複数可) は、保護されたクエリが成功すると通知されます。  | 
| [保護されたクエリが失敗しました](events-detail-reference-full.md#event-detail-protected-query-failed) | 保護されたクエリのクエリランナー、クエリ支払者、結果レシーバー (複数可) は、保護されたクエリが失敗すると通知されます。 | 
| [保護されたクエリがタイムアウトしました](events-detail-reference-full.md#event-detail-protected-query-timed-out) | 保護されたクエリのクエリランナー、クエリ支払者、結果レシーバー (複数可) は、保護されたクエリがタイムアウトすると通知されます。 | 

## EventBridge を使用した AWS Clean Rooms イベントのルーティング
<a name="eventbridge-using-events-rules-full"></a>

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

イベントバスルールの詳細な作成方法については、「*EventBridge ユーザーガイド*」の「[Creating rules that react to events](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html)」を参照してください。

### イベントに一致する AWS Clean Rooms イベントパターンの作成
<a name="eventbridge-using-events-rules-patterns-full"></a>

各イベントパターンは 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)」を参照してください。