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

# 使用 管理截止日期雲端事件 Amazon EventBridge
<a name="eventbridge-integration"></a>

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

以下是其運作方式：

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

![AWS 服務會將事件傳送至 EventBridge 預設事件匯流排。如果事件符合規則的事件模式， 會將事件 EventBridge 傳送至為該規則指定的目標。](http://docs.aws.amazon.com/zh_tw/deadline-cloud/latest/developerguide/images/eventbridge-integration-how-it-works.png)


**Topics**
+ [截止日期雲端事件](#supported-events)
+ [使用 EventBridge 規則交付截止日期雲端事件](#eventbridge-using-events-rules)
+ [截止日期雲端事件詳細資訊參考](events-detail-reference.md)

## 截止日期雲端事件
<a name="supported-events"></a>

Deadline Cloud 會自動將下列事件傳送至預設 EventBridge 事件匯流排。符合規則事件模式的事件會[盡力](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html#eb-service-event-delivery-level)交付至指定的目標。事件可能無法按順序交付。

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


| 事件詳細資訊類型 | 說明 | 
| --- | --- | 
| [已達到預算閾值](events-detail-reference.md#event-detail-budget-threshold-reached) | 當佇列達到其指派預算的百分比時傳送。 | 
| [任務生命週期狀態變更](events-detail-reference.md#event-detail-job-lifecycle-status-change) |  當任務的生命週期狀態變更時傳送。 | 
| [任務執行狀態變更](events-detail-reference.md#event-detail-job-run-status-change) | 當任務中的任務整體狀態變更時傳送。 | 
| [步驟生命週期狀態變更](events-detail-reference.md#event-detail-step-lifecycle-status-change) | 當任務中步驟的生命週期狀態變更時傳送。 | 
| [步驟執行狀態變更](events-detail-reference.md#event-detail-step-run-status-change) | 當步驟中任務的整體狀態變更時傳送。 | 
| [任務執行狀態變更](events-detail-reference.md#event-detail-task-run-status-change) | 當任務狀態變更時傳送。 | 

## 使用 EventBridge 規則交付截止日期雲端事件
<a name="eventbridge-using-events-rules"></a>

若要讓 EventBridge 預設事件匯流排將截止日期雲端事件傳送至目標，您必須建立規則。每個規則都包含一個事件模式，與事件匯流排上收到的每個事件 EventBridge 相符。如果事件資料符合指定的事件模式， 會將該事件 EventBridge 傳遞至規則的目標 (s)。

如需建立事件匯流排規則的完整說明，請參閱*EventBridge 《 使用者指南*》中的[建立對事件做出反應的規則](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html)。

### 建立符合截止日期雲端事件的事件模式
<a name="eventbridge-using-events-rules-patterns"></a>

每個事件模式都是 JSON 物件，它包含：
+ 識別傳送事件之服務的 `source` 屬性。對於截止日期雲端事件，來源為 `aws.deadline`。
+ (選擇性)：包含要比對之事件類型陣列的 `detail-type` 屬性。
+ (選擇性)：包含要比對的任何其他事件資料的 `detail` 屬性。

例如，下列事件模式會比對`farmId`為截止日期雲端指定的 的所有機群大小建議變更事件：

```
{
  "source": ["aws.deadline"],
  "detail-type": ["Fleet Size Recommendation Change"],
  "detail": {
     "farmId": "farm-12345678900000000000000000000000"
  }
}
```

如需撰寫事件模式的詳細資訊，請參閱*EventBridge 《 使用者指南*》中的[事件模式](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)。