本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 使用管理截止日期雲端事件 Amazon EventBridge 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) ## 截止日期雲端事件 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 * | 事件詳細資訊類型 | Description | | --- | --- | | [已達到預算閾值](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 規則交付截止日期雲端事件若要讓 EventBridge 預設事件匯流排將截止日期雲端事件傳送至目標，您必須建立規則。每個規則都包含一個事件模式，與事件匯流排上收到的每個事件 EventBridge 相符。如果事件資料符合指定的事件模式，會將該事件 EventBridge 傳遞至規則的目標 (s)。如需建立事件匯流排規則的完整說明，請參閱*EventBridge 《使用者指南*》中的[建立對事件做出反應的規則](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html)。 ### 建立符合截止日期雲端事件的事件模式每個事件模式都是 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)。 # 截止日期雲端事件詳細資訊參考 AWS 服務中的所有事件都有一組通用的欄位，其中包含事件的中繼資料，例如事件來源 AWS 的服務、事件產生的時間、事件發生的帳戶和區域，以及其他。如需這些一般欄位的定義，請參閱*Amazon EventBridge 《使用者指南*》中的[事件結構參考](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)。此外，每個事件都有一個 `detail` 欄位，其中包含該特定事件的特定資料。以下參考定義了各種截止日期雲端事件的詳細資訊欄位。使用 EventBridge 選取和管理截止日期雲端事件時，請謹記下列事項： + 截止日期雲端中所有事件的 `source` 欄位設定為 `aws.deadline`。 + `detail-type` 欄位指定事件類型。例如 `Fleet Size Recommendation Change`。 + `detail` 欄位包含該特定事件的特定資料。如需有關建構事件模式以讓規則符合截止日期雲端事件的資訊，請參閱*Amazon EventBridge 《使用者指南*》中的[事件模式](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)。如需事件及其 EventBridge 處理方式的詳細資訊，請參閱*Amazon EventBridge 《使用者指南*》中的[Amazon EventBridge 事件](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)。 **Topics** + [已達到預算閾值事件](#event-detail-budget-threshold-reached) + [機群大小建議變更事件](#event-detail-fleet-size-recommendation-change) + [任務生命週期狀態變更事件](#event-detail-job-lifecycle-status-change) + [任務執行狀態變更事件](#event-detail-job-run-status-change) + [步驟生命週期狀態變更事件](#event-detail-step-lifecycle-status-change) + [步驟執行狀態變更事件](#event-detail-step-run-status-change) + [任務執行狀態變更事件](#event-detail-task-run-status-change) ## 已達到預算閾值事件您可以使用 Budget Threshold Reached 事件來監控已使用的預算百分比。當使用的百分比超過下列閾值時，截止日期 Cloud 會傳送事件： + 10、20、30、40、50、60、70、75、80、85、90、95、96、97、98、99、100 截止日期雲端傳送預算閾值達到事件的頻率會隨著預算接近其限制而增加。此頻率可讓您在預算接近其限制時密切監控預算，並採取動作來避免過度支出。您也可以設定自己的預算閾值。當用量超過您的自訂閾值時，截止日期 Cloud 會傳送事件。如果您變更預算金額，則下次 Deadline Cloud 傳送預算閾值達到事件時，會根據已使用預算的目前百分比。例如，如果您將 50 USD 新增至已達到其限制的 100 USD 預算，下一個達到預算閾值事件會指出預算為 75%。以下是`Budget Threshold Reached`事件的詳細資訊欄位。以下包含 `source`和 `detail-type` 欄位，因為它們包含截止日期雲端事件的特定值。如需所有事件中包含的其他中繼資料欄位的定義，請參閱*Amazon EventBridge 《使用者指南*》中的[事件結構參考](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)。 ``` { "version": "0", "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "detail-type": "Budget Threshold Reached", "source": "aws.deadline", "account": "111122223333", "time": "2017-12-22T18:43:48Z", "region": "aa-example-1", "resources": [], "detail": { "farmId": "farm-12345678900000000000000000000000", "budgetId": "budget-12345678900000000000000000000000", "thresholdInPercent": 0 } } ``` `detail-type` 識別事件的類型。對於此事件，此值為 `Budget Threshold Reached`。 `source` 識別產生事件的服務。對於截止日期雲端事件，此值為 `aws.deadline`。 `detail` 包含事件相關資訊的 JSON 物件。產生事件的服務會決定此欄位的內容。對於此事件，此資料包含： `farmId` 包含任務的陣列識別符。 `budgetId` 已達到閾值的預算識別符。 `thresholdInPercent` 已使用的預算百分比。 ## 機群大小建議變更事件當您將機群設定為使用事件型自動擴展時，Deadline Cloud 會傳送事件，供您用來管理機群。每個事件都包含有關機群目前大小和請求大小的資訊。如需使用 EventBridge 事件和 Lambda 函數處理事件的範例，請參閱[使用截止日期雲端擴展建議功能自動擴展 Amazon EC2 機群](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/create-auto-scaling.html#autoscale-ec2-fleet)。當發生下列情況時，會傳送機群大小建議變更事件： + 當建議的機群大小變更且 oldFleetSize 與 newFleetSize 不同時。 + 當服務偵測到實際機群大小與建議的機群大小不相符時。您可以在 GetFleet 操作回應中，從 workerCount 取得實際機群大小。當作用中的 Amazon EC2 執行個體無法註冊為截止日期雲端工作者時，可能會發生這種情況。以下是`Fleet Size Recommendation Change`事件的詳細資訊欄位。以下包含 `source`和 `detail-type` 欄位，因為它們包含截止日期雲端事件的特定值。如需所有事件中包含的其他中繼資料欄位的定義，請參閱*Amazon EventBridge 《使用者指南*》中的[事件結構參考](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)。 ``` { "version": "0", "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "detail-type": "Fleet Size Recommendation Change", "source": "aws.deadline", "account": "111122223333", "time": "2017-12-22T18:43:48Z", "region": "aa-example-1", "resources": [], "detail": { "farmId": "farm-12345678900000000000000000000000", "fleetId": "fleet-12345678900000000000000000000000", "oldFleetSize": 1, "newFleetSize": 5, } } ``` `detail-type` 識別事件的類型。對於此事件，此值為 `Fleet Size Recommendation Change`。 `source` 識別產生事件的服務。對於截止日期雲端事件，此值為 `aws.deadline`。 `detail` 包含事件相關資訊的 JSON 物件。產生事件的服務會決定此欄位的內容。對於此事件，此資料包含： `farmId` 包含任務的陣列識別符。 `fleetId` 需要變更大小的機群識別符。 `oldFleetSize` 機群的目前大小。 `newFleetSize` 建議的機群新大小。 ## 任務生命週期狀態變更事件當您建立或更新任務時，截止日期雲端會設定生命週期狀態，以顯示最近使用者啟動動作的狀態。任務生命週期狀態變更事件會針對任何生命週期狀態變更傳送，包括建立任務的時間。以下是`Job Lifecycle Status Change`事件的詳細資訊欄位。以下包含 `source`和 `detail-type` 欄位，因為它們包含截止日期雲端事件的特定值。如需所有事件中包含的其他中繼資料欄位的定義，請參閱*Amazon EventBridge 《使用者指南*》中的[事件結構參考](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)。 ``` { "version": "0", "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "detail-type": "Job Lifecycle Status Change", "source": "aws.deadline", "account": "111122223333", "time": "2017-12-22T18:43:48Z", "region": "aa-example-1", "resources": [], "detail": { "farmId": "farm-12345678900000000000000000000000", "queueId": "queue-12345678900000000000000000000000", "jobId": "job-12345678900000000000000000000000", "previousLifecycleStatus": "UPDATE_IN_PROGRESS", "lifecycleStatus": "UPDATE_SUCCEEDED" } } ``` `detail-type` 識別事件的類型。對於此事件，此值為 `Job Lifecycle Status Change`。 `source` 識別產生事件的服務。對於截止日期雲端事件，此值為 `aws.deadline`。 `detail` 包含事件相關資訊的 JSON 物件。產生事件的服務會決定此欄位的內容。對於此事件，此資料包含： `farmId` 包含任務的陣列識別符。 `queueId` 包含任務之佇列的識別符。 `jobId` 任務的識別符。 `previousLifecycleStatus` 任務要離開的生命週期狀態。當您第一次提交任務時，不會包含此欄位。 `lifecycleStatus` 任務進入的生命週期狀態。 ## 任務執行狀態變更事件任務由許多任務組成。每個任務都有一個狀態。所有任務的狀態都會合併，以提供任務的整體狀態。如需詳細資訊，請參閱[《截止日期雲端使用者指南》中的截止日期雲端中的任務狀態](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/jobs-states.html)。 *AWS * 任務執行狀態變更事件會在下列情況下傳送： + 合併[taskRunStatus](#job-run-status-change-field-5)欄位會變更。 + 除非任務處於就緒狀態，否則任務會重新排入佇列。下列情況下，不會傳送任務執行狀態變更事件： + 任務會先建立。若要監控任務建立，請監控任務生命週期狀態變更事件的變更。 + 任務[taskRunStatusCounts](#job-run-status-change-field-6)的欄位會變更，但合併任務執行狀態不會變更。以下是`Job Run Status Change`事件的詳細資訊欄位。以下包含 `source`和 `detail-type` 欄位，因為它們包含截止日期雲端事件的特定值。如需所有事件中包含的其他中繼資料欄位的定義，請參閱*Amazon EventBridge 《使用者指南*》中的[事件結構參考](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)。 ``` { "version": "0", "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "detail-type": "Job Run Status Change", "source": "aws.deadline", "account": "111122223333", "time": "2017-12-22T18:43:48Z", "region": "aa-example-1", "resources": [], "detail": { "farmId": "farm-12345678900000000000000000000000", "queueId": "queue-12345678900000000000000000000000", "jobId": "job-12345678900000000000000000000000", "previousTaskRunStatus": "RUNNING", "taskRunStatus": "SUCCEEDED", "taskRunStatusCounts": { "PENDING": 0, "READY": 0, "RUNNING": 0, "ASSIGNED": 0, "STARTING": 0, "SCHEDULED": 0, "INTERRUPTING": 0, "SUSPENDED": 0, "CANCELED": 0, "FAILED": 0, "SUCCEEDED": 20, "NOT_COMPATIBLE": 0 } } } ``` `detail-type` 識別事件的類型。對於此事件，此值為 `Job Run Status Change`。 `source` 識別產生事件的服務。對於截止日期雲端事件，此值為 `aws.deadline`。 `detail` 包含事件相關資訊的 JSON 物件。產生事件的服務會決定此欄位的內容。對於此事件，此資料包含： `farmId` 包含任務的陣列識別符。 `queueId` 包含任務之佇列的識別符。 `jobId` 任務的識別符。 `previousTaskRunStatus` 任務要離開的任務執行狀態。 `taskRunStatus` 任務正在進入的任務執行狀態。 `taskRunStatusCounts` 每個狀態的任務數量。 ## 步驟生命週期狀態變更事件當您建立或更新事件時，截止日期雲端會設定任務的生命週期狀態，以描述最近使用者啟動動作的狀態。步驟生命週期狀態變更事件會在下列情況下傳送： + 步驟更新開始 (UPDATE\$1IN\$1PROGRESS)。 + 步驟更新已成功完成 (UPDATE\$1SUCCEEDED)。 + 步驟更新失敗 (UPDATE\$1FAILED)。第一次建立步驟時，不會傳送事件。若要監控步驟建立，請監控任務生命週期狀態變更事件的變更。以下是`Step Lifecycle Status Change`事件的詳細資訊欄位。以下包含 `source`和 `detail-type` 欄位，因為它們包含截止日期雲端事件的特定值。如需所有事件中包含的其他中繼資料欄位的定義，請參閱*Amazon EventBridge 《使用者指南*》中的[事件結構參考](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)。 ``` { "version": "0", "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "detail-type": "Step Lifecycle Status Change", "source": "aws.deadline", "account": "111122223333", "time": "2017-12-22T18:43:48Z", "region": "aa-example-1", "resources": [], "detail": { "farmId": "farm-12345678900000000000000000000000", "queueId": "queue-12345678900000000000000000000000", "jobId": "job-12345678900000000000000000000000", "stepId": "step-12345678900000000000000000000000", "previousLifecycleStatus": "UPDATE_IN_PROGRESS", "lifecycleStatus": "UPDATE_SUCCEEDED" } } ``` `detail-type` 識別事件的類型。對於此事件，此值為 `Step Lifecycle Status Change`。 `source` 識別產生事件的服務。對於截止日期雲端事件，此值為 `aws.deadline`。 `detail` 包含事件相關資訊的 JSON 物件。產生事件的服務會決定此欄位的內容。對於此事件，此資料包含： `farmId` 包含任務的陣列識別符。 `queueId` 包含任務之佇列的識別符。 `jobId` 任務的識別符。 `stepId` 目前任務步驟的識別符。 `previousLifecycleStatus` 步驟要離開的生命週期狀態。 `lifecycleStatus` 步驟進入的生命週期狀態。 ## 步驟執行狀態變更事件任務中的每個步驟都由許多任務組成。每個任務都有一個狀態。任務狀態會合併，以提供步驟和任務的整體狀態。步驟執行狀態變更事件會在下列情況下傳送： + 合併[taskRunStatus](#step-run-status-change-field-6)的變更。 + 步驟會重新排入佇列，除非該步驟處於就緒狀態。發生下列情況時，不會傳送事件： + 步驟會先建立。若要監控步驟建立，請監控任務生命週期狀態變更事件的變更。 + 步驟[taskRunStatusCounts](#step-run-status-change-field-7)的變更，但合併的步驟任務執行狀態不會變更。以下是`Step Run Status Change`事件的詳細資訊欄位。以下包含 `source`和 `detail-type` 欄位，因為它們包含截止日期雲端事件的特定值。如需所有事件中包含的其他中繼資料欄位的定義，請參閱*Amazon EventBridge 《使用者指南*》中的[事件結構參考](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)。 ``` { "version": "0", "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "detail-type": "Step Run Status Change", "source": "aws.deadline", "account": "111122223333", "time": "2017-12-22T18:43:48Z", "region": "aa-example-1", "resources": [], "detail": { "farmId": "farm-12345678900000000000000000000000", "queueId": "queue-12345678900000000000000000000000", "jobId": "job-12345678900000000000000000000000", "stepId": "step-12345678900000000000000000000000", "previousTaskRunStatus": "RUNNING", "taskRunStatus": "SUCCEEDED", "taskRunStatusCounts": { "PENDING": 0, "READY": 0, "RUNNING": 0, "ASSIGNED": 0, "STARTING": 0, "SCHEDULED": 0, "INTERRUPTING": 0, "SUSPENDED": 0, "CANCELED": 0, "FAILED": 0, "SUCCEEDED": 20, "NOT_COMPATIBLE": 0 } } } ``` `detail-type` 識別事件的類型。對於此事件，此值為 `Step Run Status Change`。 `source` 識別產生事件的服務。對於截止日期雲端事件，此值為 `aws.deadline`。 `detail` 包含事件相關資訊的 JSON 物件。產生事件的服務會決定此欄位的內容。對於此事件，此資料包含： `farmId` 包含任務的陣列識別符。 `queueId` 包含任務之佇列的識別符。 `jobId` 任務的識別符。 `stepId` 目前任務步驟的識別符。 `previousTaskRunStatus` 步驟要離開的執行狀態。 `taskRunStatus` 步驟進入的執行狀態。 `taskRunStatusCounts` 每個狀態中步驟的任務數量。 ## 任務執行狀態變更事件 [runStatus](#task-run-status-change-field-7) 欄位會在任務執行時更新。事件會在下列情況下傳送： + 任務的執行狀態會變更。 + 除非任務處於 READY 狀態，否則任務會重新排入佇列。發生下列情況時，不會傳送事件： + 任務會先建立。若要監控任務建立，請監控任務生命週期狀態變更事件的變更。以下是`Task Run Status Change`事件的詳細資訊欄位。以下包含 `source`和 `detail-type` 欄位，因為它們包含截止日期雲端事件的特定值。如需所有事件中包含的其他中繼資料欄位的定義，請參閱*Amazon EventBridge 《使用者指南*》中的[事件結構參考](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)。 ``` { "version": "0", "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "detail-type": "Task Run Status Change", "source": "aws.aws.deadline", "account": "111122223333", "time": "2017-12-22T18:43:48Z", "region": "aa-example-1", "resources": [], "detail": { "farmId": "farm-12345678900000000000000000000000", "queueId": "queue-12345678900000000000000000000000", "jobId": "job-12345678900000000000000000000000", "stepId": "step-12345678900000000000000000000000", "taskId": "task-12345678900000000000000000000000-0", "previousRunStatus": "RUNNING", "runStatus": "SUCCEEDED" } } ``` `detail-type` 識別事件的類型。對於此事件，此值為 `Fleet Size Recommendation Change`。 `source` 識別產生事件的服務。對於截止日期雲端事件，此值為 `aws.deadline`。 `detail` 包含事件相關資訊的 JSON 物件。產生事件的服務會決定此欄位的內容。對於此事件，此資料包含： `farmId` 包含任務的陣列識別符。 `queueId` 包含任務之佇列的識別符。 `jobId` 任務的識別符。 stepId 目前任務步驟的識別符。 `taskId` 執行中任務的識別符。 `previousRunStatus` 任務要離開的執行狀態。 `runStatus` 任務進入的執行狀態。