共用方式為


工作排程失敗事件

當工作無法排程且將於稍後重試,便會發出此事件。 這是排程工作時因資源限制的暫時失敗,例如:節點的可用位置不足以執行已指定 requiredSlots 的工作。

下列範例顯示工作排程失敗事件的內文。

{
    "jobId": "job-01",
    "id": "task-01",
    "taskType": "User",
    "systemTaskVersion": 665378862,
    "requiredSlots": 1,
    "nodeInfo": {
        "poolId": "pool-01",
        "nodeId": " "
    },
    "multiInstanceSettings": {
        "numberOfInstances": 1
    },
    "constraints": {
        "maxTaskRetryCount": 0
    },
    "schedulingError": {
        "category": "UserError",
        "code": "JobPreparationTaskFailed",
        "message": "Task cannot run because the job preparation task failed on node"
    }
}
元素名稱 類型 注意
jobId String 含有工作的作業識別碼。
id String 工作識別碼。
taskType String 工作類型。 可以是 'JobManager',表示這是作業管理員工作,或是 'User',表示不是作業管理員工作。 對於作業準備工作、作業發行工作或開始工作。不會發出此事件。
systemTaskVersion Int32 這是作業上的內部重試計數器。 Batch 服務可在內部重試工作,以處理暫時性問題。 這些問題包含內部排程錯誤,或嘗試從不正常狀態的計算節點復原。
requiredSlots Int32 執行工作所需的位置。
nodeInfo 複雜類型 包含工作執行所在計算節點的相關資訊。
multiInstanceSettings 複雜類型 指定工作為需要多個計算節點的多重執行個體工作。 如需詳細資訊,請參閱<multiInstanceSettings>。
constraints 複雜類型 套用至此工作的執行限制。
schedulingError 複雜類型 包含工作排程錯誤的相關資訊。

nodeInfo

元素名稱 類型 注意
poolId String 工作執行所在集區的識別碼。
nodeId String 工作執行所在節點的識別碼。

multiInstanceSettings

元素名稱 類型 注意
numberOfInstances Int32 工作需要的計算節點數目。

條件約束

元素名稱 類型 注意
maxTaskRetryCount Int32 工作重試次數上限。 如果工作的結束代碼不是零,Batch 服務會重試工作。

請注意,這個值會特別控制重試次數。 Batch 服務會嘗試工作一次,然後可一直重試直到達此限制。 例如,如果重試計數上限為 3,則 Batch 可嘗試工作最多 4 次 (一次首次嘗試,3 次重試)。

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

如果重試計數上限為 -1,則 Batch 服務會無限制地重試工作。

預設值為 0 (不重試)。

schedulingError

元素名稱 類型 注意
category String 錯誤類別。
code String 工作排程錯誤的識別碼。 程式碼不變,且要以程式設計方式使用。
message String 描述工作排程錯誤的訊息,以便在使用者介面中顯示。