本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 EventBridge 來監控 CloudFormation 和 Git 同步事件
<a name="eventbridge-integration"></a>

Amazon EventBridge 是一種無伺服器服務，該服務使用事件將應用程式元件連接在一起，讓您更輕鬆地建置可擴展的事件驅動型應用程式。事件驅動型架構是一種建置鬆耦合軟體系統的方式，透過發出和回應事件來協作。事件代表資源或環境中的變更。

如同許多 AWS 服務，CloudFormation 會產生事件並將其傳送至 EventBridge 預設事件匯流排，而 EventBridge 預設事件匯流排會在每個匯流排中自動佈建 AWS 帳戶。事件匯流排是接收事件，並將事件傳遞至零個或多個目的地或*目標*的路由器。為事件匯流排指定的規則會在事件到達時評估事件。每項規則都會檢查事件是否與規則的*事件模式*相符。如果事件不相符，事件匯流排會將事件傳送至指定的目標。

如需詳細資訊，請參閱 *《Amazon EventBridge 使用者指南》*中的 [Amazon EventBridge 入門](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-get-started.html)。

![AWS 服務會將事件傳送至 EventBridge 預設事件匯流排。如果事件與規則的事件模式相符，則 EventBridge 會將事件傳送至該規則的指定目標。](http://docs.aws.amazon.com/zh_tw/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)。


| 事件類型 | Description | 事件來源 | 
| --- | --- | --- | 
| [資源狀態變更](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)。


| 事件類型 | Description | 事件來源 | 
| --- | --- | --- | 
| [儲存庫同步狀態變更](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)。