本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 截止日期雲端事件詳細資訊參考 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` 任務進入的執行狀態。