# EventBridge による CloudFormation および Git 同期イベントのモニタリング
<a name="eventbridge-integration"></a>

Amazon EventBridge は、イベントを使用してアプリケーションコンポーネント同士を接続するサーバーレスサービスです。これにより、スケーラブルなイベント駆動型アプリケーションを簡単に構築できます。イベント駆動型アーキテクチャとは、イベントの発信と応答によって連携する、疎結合のソフトウェアシステムを構築するスタイルです。イベントとは、リソースまたは環境で発生した変更を指します。

多くの AWS のサービスと同様に、CloudFormation は、すべての AWS アカウントに自動的にプロビジョニングされている EventBridge のデフォルトのイベントバスにイベントを生成して送信します。イベントバスは、イベントを受信して、ゼロ個以上の送信先 (*ターゲット*) に配信するルーターです。イベントが受信されると、ユーザーがイベントバスに対して指定したルールによって評価されます。各ルールは、イベントがルールの*イベントパターン*に一致するかどうかをチェックします。一致する場合、イベントバスはそのイベントを指定されたターゲットに送信します。

詳細については、「*Amazon EventBridge ユーザーガイド*」の「[Getting started with Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-get-started.html)」を参照してください。

![AWS のサービスは、EventBridge のデフォルトのイベントバスにイベントを送信します。イベントがルールのイベントパターンに一致すると、EventBridge は、そのルールで指定されたターゲットに、イベントを送信します。](http://docs.aws.amazon.com/ja_jp/AWSCloudFormation/latest/UserGuide/images/eventbridge-integration-how-it-works.png)


**Topics**
+ [CloudFormation および Git 同期イベントの概要](#supported-events)
+ [Amazon EventBridge アクセス許可](#eventbridge-permissions)
+ [EventBridge ルールのカスタムイベントパターンの作成](eventbridge-using-events-rules-patterns.md)
+ [CloudFormation イベントの詳細リファレンス](events-detail-reference.md)

## CloudFormation および Git 同期イベントの概要
<a name="supported-events"></a>

CloudFormation は、スタックに対する作成、更新、削除、またはドリフト検出操作が実行されるたびに、EventBridge にイベントを送信します。また、CloudFormation は、スタックセットとスタックセットインスタンスのステータス変更について EventBridge にイベントを送信します。EventBridge ルールを使用すると、イベントを定義したターゲットにルートできます。これらのイベントは配信されることが保証されているため、順不同で配信される場合があります。

CloudFormation イベントはスタックまたはスタックセットとそのリソースの変更を表すため、それらを使用してそれぞれのイベントに関連するワークフローを開始できます。例えば、次のようになります。
+ CloudFormation を使用してプロビジョニングされたすべてのリソースに、スタックまたはスタックセット固有のタグを作成します。
+ CloudFormation スタックまたはスタックセットと Amazon WorkSpaces Application Manager (Amazon WAM) との関連付けを確立します。
+ 作成されたスタックまたはスタックセットの AppRegistry との関連付けを指定します。

以下のイベントは CloudFormation によって生成され、EventBridge のデフォルトのイベントバスに送信されます。詳細については、「[CloudFormation イベントの詳細リファレンス](events-detail-reference.md)」を参照してください。


| イベントタイプ | 説明 | イベントソース | 
| --- | --- | --- | 
| [リソースのステータスの変更](event-detail-resource-status-change.md) | スタック上で実行され、基になるリソースプロパティが変更されるすべての更新。<br />サポートされている AWS リソースタイプの一覧については、「[AWS リソースおよびプロパティタイプのリファレンス](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-template-resource-type-ref.html)」を参照してください。 | AWS CloudFormation | 
| [スタックのステータスの変更](event-detail-stack-status-change.md) | 特定のスタックのステータス変更を表します。<br />コードの詳細については、「[スタックステータスコード](view-stack-events.md#cfn-console-view-stack-data-resources-status-codes)」を参照してください。 | AWS CloudFormation | 
| [ドリフト検出のステータスの変更](event-detail-stack-drift-detection-change.md) | 特定のスタックでユーザーが開始したドリフト検出更新を表します。<br />ドリフト検出をサポートする完全なミュータブル型イミュータブル型の全数リストについては、「[リソースタイプのサポート](resource-import-supported-resources.md)」を参照してください。 | AWS CloudFormation | 
| [StackSet のステータスの変更](event-detail-stackset-status-change.md) | 特定のスタックセットのステータス変更を表します。 | AWS CloudFormation | 
| [StackSet スタックインスタンスのステータスの変更](event-detail-stackset-stack-instance-status-change.md) | 特定の StackSet スタックインスタンスへのステータス変更を表します。<br />コードの詳細については、「[スタックインスタンスのステータスコード](stacksets-concepts.md#stack-instance-status-codes)」を参照してください。 | AWS CloudFormation | 
| [StackSet オペレーションステータス](event-detail-stackset-operation-status-change.md) | 特定の StackSet オペレーションのステータス変更を表します。<br />コードの詳細については、「[StackSets ステータスコード](stacksets-concepts.md#stackset-status-codes)」を参照してください。 | AWS CloudFormation | 

さらに、AWS CloudFormation の Git 同期は、リポジトリ同期とリソース同期のステータス変更に関するイベントを EventBridge に送信します。

以下の Git 同期イベントは CodeConnections によって生成され、EventBridge のデフォルトイベントバスに送信されます。詳細については、「[CloudFormation イベントの詳細リファレンス](events-detail-reference.md)」を参照してください。


| イベントタイプ | 説明 | イベントソース | 
| --- | --- | --- | 
| [リポジトリ同期ステータスの変更](event-detail-respository-sync-status-change.md) | Git リポジトリの同期ステータスの変更を表します。 | AWS CodeConnections | 
| [リソース同期ステータスの変更](event-detail-resource-sync-status-change.md) | Git リソース同期のステータス変更を表します。 | AWS CodeConnections | 

## Amazon EventBridge アクセス許可
<a name="eventbridge-permissions"></a>

CloudFormation には、EventBridge にイベントを配信するための追加のアクセス許可は必要ありません。イベントには、CloudFormation の API オペレーションを通じて既に入手可能な情報が含まれています。

指定するターゲットに、特定のアクセス許可または設定が必要になることがあります。ターゲットに特定のサービスを使用する方法の詳細については、Amazon EventBridge ユーザーガイドの「[Amazon EventBridge ターゲット](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html)」を参照してください。