截止日期雲端事件詳細資訊參考 - 截止日期雲端

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

截止日期雲端事件詳細資訊參考

來自 AWS 服務的所有事件都有一組通用的欄位,其中包含有關事件的中繼資料,例如事件來源 AWS 的服務、事件產生的時間、事件發生的帳戶和區域等。如需這些一般欄位的定義,請參閱Amazon EventBridge 《 使用者指南》中的事件結構參考

此外,每個事件都有一個 detail 欄位,其中包含該特定事件的特定資料。以下參考定義了各種截止日期雲端事件的詳細資訊欄位。

使用 EventBridge 選取和管理截止日期雲端事件時,請記住下列事項:

  • 截止日期雲端中所有事件的 source 欄位設定為 aws.deadline

  • detail-type 欄位指定事件類型。

    例如 Fleet Size Recommendation Change

  • detail 欄位包含該特定事件的特定資料。

如需有關建構事件模式以讓規則符合截止日期雲端事件的資訊,請參閱Amazon EventBridge 《 使用者指南》中的事件模式

如需事件及其 EventBridge 處理方式的詳細資訊,請參閱Amazon EventBridge 《 使用者指南》中的Amazon EventBridge 事件

已達到預算閾值事件

您可以使用 Budget Threshold Reached 事件來監控已使用的預算百分比。當使用的百分比超過下列閾值時,截止日期 Cloud 會傳送事件:

  • 10、20、30、40、50、60、70、75、80、85、90、95、96、97、98、99、100

截止日期雲端傳送預算閾值達到事件的頻率會隨著預算接近其限制而增加。這可讓您在預算接近其限制時密切監控預算,並採取動作來避免過度支出。您也可以設定自己的預算閾值。截止日期 雲端會在使用量超過您的自訂閾值時傳送事件。

如果您變更預算金額,則下次 Deadline Cloud 傳送預算閾值達到事件時,會根據已使用的預算目前百分比。例如,如果您將 50 USD 新增至已達到其限制的 100 USD 預算,下一個達到預算閾值的事件會指出預算為 75%。

以下是Budget Threshold Reached事件的詳細資訊欄位。

以下包含 sourcedetail-type 欄位,因為它們包含截止日期雲端事件的特定值。如需所有事件中包含的其他中繼資料欄位的定義,請參閱Amazon EventBridge 《 使用者指南》中的事件結構參考

{ "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 機群

當發生下列情況時,會傳送機群大小建議變更事件:

  • 當建議的機群大小變更且 oldFleetSize 與 newFleetSize 不同時。

  • 當服務偵測到實際機群大小與建議的機群大小不相符時。您可以從 GetFleet 操作回應中的 workerCount 取得實際機群大小。當作用中的 Amazon EC2 執行個體無法註冊為截止日期雲端工作者時,可能會發生這種情況。

以下是Fleet Size Recommendation Change事件的詳細資訊欄位。

以下包含 sourcedetail-type 欄位,因為它們包含截止日期雲端事件的特定值。如需所有事件中包含的其他中繼資料欄位的定義,請參閱Amazon EventBridge 《 使用者指南》中的事件結構參考

{ "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事件的詳細資訊欄位。

以下包含 sourcedetail-type 欄位,因為它們包含截止日期雲端事件的特定值。如需所有事件中包含的其他中繼資料欄位的定義,請參閱Amazon EventBridge 《 使用者指南》中的事件結構參考

{ "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

任務進入的生命週期狀態。

任務執行狀態變更事件

任務由許多任務組成。每個任務都有一個狀態。所有任務的狀態都會合併,以提供任務的整體狀態。如需詳細資訊,請參閱《截止日期雲端使用者指南》中的截止日期雲端中的任務狀態AWS

下列情況下會傳送任務執行狀態變更事件:

  • 合併taskRunStatus欄位會變更。

  • 除非任務處於 READY 狀態,否則任務會重新排入佇列。

下列情況下,不會傳送任務執行狀態變更事件:

  • 任務會先建立。若要監控任務建立,請監控任務生命週期狀態變更事件的變更。

  • 任務taskRunStatusCounts的欄位會變更,但合併任務執行狀態不會變更。

以下是Job Run Status Change事件的詳細資訊欄位。

以下包含 sourcedetail-type 欄位,因為它們包含截止日期雲端事件的特定值。如需所有事件中包含的其他中繼資料欄位的定義,請參閱Amazon EventBridge 《 使用者指南》中的事件結構參考

{ "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_IN_PROGRESS)。

  • 步驟更新已成功完成 (UPDATE_SUCEEDED)。

  • 步驟更新失敗 (UPDATE_FAILED)。

第一次建立步驟時,不會傳送事件。若要監控步驟建立,請監控任務生命週期狀態變更事件的變更。

以下是Step Lifecycle Status Change事件的詳細資訊欄位。

以下包含 sourcedetail-type 欄位,因為它們包含截止日期雲端事件的特定值。如需所有事件中包含的其他中繼資料欄位的定義,請參閱Amazon EventBridge 《 使用者指南》中的事件結構參考

{ "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的變更。

  • 步驟會重新排入佇列,除非該步驟處於 READY 狀態。

發生下列情況時,不會傳送事件:

  • 步驟會先建立。若要監控步驟建立,請監控任務生命週期狀態變更事件的變更。

  • 步驟taskRunStatusCounts的變更,但合併的步驟任務執行狀態不會變更。

以下是Step Run Status Change事件的詳細資訊欄位。

以下包含 sourcedetail-type 欄位,因為它們包含截止日期雲端事件的特定值。如需所有事件中包含的其他中繼資料欄位的定義,請參閱Amazon EventBridge 《 使用者指南》中的事件結構參考

{ "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 欄位會在任務執行時更新。事件會在下列情況下傳送:

  • 任務的執行狀態會變更。

  • 除非任務處於 READY 狀態,否則任務會重新排入佇列。

發生下列情況時,不會傳送事件:

  • 任務會先建立。若要監控任務建立,請監控任務生命週期狀態變更事件的變更。

以下是Task Run Status Change事件的詳細資訊欄位。

以下包含 sourcedetail-type 欄位,因為它們包含截止日期雲端事件的特定值。如需所有事件中包含的其他中繼資料欄位的定義,請參閱Amazon EventBridge 《 使用者指南》中的事件結構參考

{ "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

任務進入的執行狀態。