任務完成事件

不論結束代碼為何,工作完成之後就會發出此事件。 此事件可用來判斷工作的持續時間、工作執行位置,以及是否重試。

下列範例顯示工作完成事件的主體。

{
    "jobId": "myJob",
    "id": "myTask",
    "taskType": "User",
    "systemTaskVersion": 0,
    "requiredSlots": 1,
    "nodeInfo": {
        "poolId": "pool-001",
        "nodeId": "tvm-257509324_1-20160908t162728z"
    },
    "multiInstanceSettings": {
        "numberOfInstances": 1
    },
    "constraints": {
        "maxTaskRetryCount": 2
    },
    "executionInfo": {
        "startTime": "2016-09-08T16:32:23.799Z",
        "endTime": "2016-09-08T16:34:00.666Z",
        "exitCode": 0,
        "retryCount": 0,
        "requeueCount": 0,
        "result": "Success",
        "schedulingError": {
            "category": "",
            "code": "",
            "message": "",
            "details": []
        }
    }
}
元素名稱 類型 註釋
jobId 繩子 包含工作的作業標識碼。
id 繩子 工作識別碼。
taskType 繩子 工作的型別。 任務類型可以是「JobManager」表示是工作管理員任務,或是「User」表示不是工作管理員任務。 此事件不會用於工作準備任務、工作釋放任務或開始任務。
systemTaskVersion Int32 工作上的內部重試計數器。 在內部,Batch 服務可以重試工作以考慮暫時性問題。 這些問題可能包括內部排程錯誤,或嘗試從處於不良狀態的計算節點復原。
requiredSlots Int32 執行工作所需的位置。
nodeInfo 複雜類型 包含工作執行所在的計算節點相關信息。
multiInstanceSettings 複雜類型 指定工作是需要多個計算節點的多實例工作。 如需詳細資訊,請參閱 multiInstanceSettings
constraints 複雜類型 套用至此工作的執行條件約束。
executionInfo 複雜類型 包含工作執行的相關信息。

nodeInfo

元素名稱 類型 註釋
poolId 繩子 工作執行所在的集區標識碼。
nodeId 繩子 工作執行所在的節點識別碼。

multiInstanceSettings

元素名稱 類型 註釋
numberOfInstances Int32 工作所需的計算節點數目。

限制式

元素名稱 類型 註釋
maxTaskRetryCount Int32 任務可重試的最大次數。 如果 Batch 服務結束代碼為非零,則會重試工作。

這個值會特別控制重試次數。 批次服務會嘗試一次任務,然後可能會重複嘗試到這個限制。 例如,如果最大重試次數是 3 次,批次會嘗試同一任務最多四次(一次初次嘗試,三次重試)。

如果重試計數上限為0,Batch服務就不會重試工作。

如果重試計數上限為 -1,Batch 服務會重試沒有限制的工作。

預設值為 0(沒有重試)。

executionInfo

元素名稱 類型 註釋
startTime 日期時間 工作開始執行的時間。 「執行中」對應 於執行 狀態,因此如果任務指定資源檔案或應用程式套件,則啟動時間反映任務開始下載或部署這些資源檔案或應用程式套件的時間。 如果工作重新啟動或重試,這是工作開始執行的最新時間。
endTime 日期時間 工作完成的時間。
exitCode Int32 工作的結束代碼。 如果任務在開始執行前失敗,則 exitCode 為空。
retryCount Int32 批次服務重試該任務的次數。 如果工作以非零結束代碼結束,則工作會重試,最多到指定的 MaxTaskRetryCount。
requeueCount Int32 批次服務因使用者請求而重新排隊該任務的次數。

當節點從池中移除(透過調整大小或縮小)或工作被停用時,你可以選擇重新排隊那些節點上的正在執行的任務。 這個計數會追蹤因這些原因而重新排隊任務的次數。
result 繩子 任務結果字串,可以是「成功」或「失敗」
schedulingError 複雜類型 包含關於錯誤的詳細資訊。

排程錯誤

元素名稱 類型 註釋
category 繩子 錯誤類別,例如「UserError」。
code 繩子 錯誤代碼,例如「FailureExitCode」。
message 繩子 錯誤訊息。
details Array 錯誤詳細數據。