任务完成事件

无论退出代码如何,任务完成后都会发出此事件。 此事件可用于确定任务的持续时间、运行位置以及是否重试过。

以下示例显示了任务完成事件的正文。

{
    "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
    }
}
元素名称 类型 注释
jobId 字符串 包含任务的作业的 ID。
id 字符串 任务的 ID。
taskType 字符串 任务的类型。 它可以是“JobManager”(指示它是作业管理器任务),也可以是“User”(指示它并非作业管理器任务)。 对于作业准备任务、作业释放任务或开始任务,不会发出此事件。
systemTaskVersion Int32 这是任务上的内部重试计数器。 批处理服务可能会在内部重试任务来解决暂时性问题。 这些问题可能包括内部计划错误或尝试恢复处于错误状态的计算节点。
requiredSlots Int32 运行任务所需的槽。
nodeInfo 复杂类型 包含有关运行任务的计算节点的信息。
multiInstanceSettings 复杂类型 指定任务是需要多个计算节点的多实例任务。 有关详细信息,请参阅multiInstanceSettings
constraints 复杂类型 应用到此任务的执行约束。
executionInfo 复杂类型 包含有关任务执行的信息。

nodeInfo

元素名称 类型 注释
poolId 字符串 运行任务的池的 ID。
nodeId 字符串 运行任务的节点的 ID。

multiInstanceSettings

元素名称 类型 说明
numberOfInstances Int32 任务所需的计算节点数。

constraints

元素名称 类型 说明
maxTaskRetryCount Int32 可以重试任务的最大次数。 批处理服务在其退出代码非零时重试任务。

请注意,此值专门用于控制重试的次数。 批处理服务将尝试任务一次,然后重试,直至达到此上限为止。 例如,如果最大重试计数为 3,则批处理任务最多尝试任务 4 次(一次是初始尝试,其余 3 次是重试)。

如果最大重试计数为 0,则批处理服务不会重试任务。

如果最大重试计数为 -1,则批处理服务会无限制地重试任务。

默认值为 0(不重试)。

executionInfo

元素名称 类型 说明
startTime DateTime 任务开始运行的时间。 “Running”对应于正在运行状态,因此如果任务指定资源文件或应用程序包,则开始时间反映了任务开始下载或部署这些内容的时间。 如果任务已重启或重试,该时间是任务开始运行的最近时间。
endTime DateTime 任务完成的时间。
exitCode Int32 任务的退出代码。
retryCount Int32 批处理服务重试任务的次数。 如果任务使用非零退出代码退出,该任务会重试,直至达到指定的 MaxTaskRetryCount。
requeueCount Int32 批处理服务因用户请求而对任务进行重新排队的次数。

当用户从池中删除节点(通过调整池的大小或缩小池)或作业已禁用时,用户可以指定节点上运行的任务重新排队等待执行。 此计数跟踪由于这些原因而重新排队任务的次数。