Partilhar via


Evento de início de tarefa

Esse evento é emitido quando uma tarefa é agendada para iniciar em um nó de computação pelo agendador. Se a tarefa for repetida ou colocada novamente na fila, esse evento será emitido novamente para a mesma tarefa. A contagem de tentativas e a versão da tarefa do sistema serão atualizadas de acordo.

O exemplo a seguir mostra o corpo de um evento de início de tarefa.

{
    "jobId": "myJob",
    "id": "myTask",
    "taskType": "User",
    "systemTaskVersion": 220192842,
    "requiredSlots": 1,
    "nodeInfo": {
        "poolId": "pool-001",
        "nodeId": "tvm-257509324_1-20160908t162728z"
    },
    "multiInstanceSettings": {
        "numberOfInstances": 1
    },
    "constraints": {
        "maxTaskRetryCount": 2
    },
    "executionInfo": {
        "retryCount": 0
    }
}
Nome do elemento Tipo Observações
jobId Cordão A ID do trabalho que contém a tarefa.
id Cordão O identificador da tarefa.
taskType Cordão O tipo de tarefa. É um 'JobManager' indicando que é uma tarefa do gerenciador de tarefas ou 'User' indicando que não é uma tarefa do gerenciador de tarefas.
systemTaskVersion Int32 O contador de tentativas interno em uma tarefa. Internamente, o serviço de lote tenta novamente uma tarefa para levar em conta problemas transitórios. Esses problemas incluem erros de agendamento interno ou tentativas de recuperação de nós de computação em mau estado.
requiredSlots Int32 Os slots necessários para executar a tarefa.
nodeInfo Tipo Complexo Contém informações sobre o nó de computação no qual a tarefa foi executada.
multiInstanceSettings Tipo Complexo Especifica que a tarefa é Multi-Instance Task que requer vários nós de computação. Consulte multiInstanceSettings para obter detalhes.
constraints Tipo Complexo As restrições de execução que se aplicam a esta tarefa.
executionInfo Tipo Complexo Contém informações sobre a execução da tarefa.

nodeInfo

Nome do elemento Tipo Observações
poolId Cordão A ID do pool no qual a tarefa foi executada.
nodeId Cordão A ID do nó no qual a tarefa foi executada.

multiInstanceSettings

Nome do elemento Tipo Observações
numberOfInstances int O número de nós de computação exigidos pela tarefa.

Restrições

Nome do elemento Tipo Observações
maxTaskRetryCount Int32 O número máximo de vezes que a tarefa é repetida. O serviço de lote tenta novamente uma tarefa se seu código de saída for diferente de zero.

Esse valor controla especificamente o número de tentativas. O serviço de lote tenta a tarefa uma vez e, em seguida, pode tentar novamente até esse limite. Por exemplo, se a contagem máxima de tentativas for 3, o Batch tentará uma tarefa até 4 vezes (uma tentativa inicial e 3 tentativas).

Se a contagem máxima de tentativas for 0, o serviço em lote não repetirá tarefas.

Se a contagem máxima de tentativas for -1, o serviço de lote repetirá tarefas sem limite.

O valor padrão é 0 (sem tentativas).

executionInfo

Nome do elemento Tipo Observações
retryCount Int32 O número de vezes que a tarefa é repetida pelo serviço Batch. A tarefa será repetida se sair com um código de saída diferente de zero, até o MaxTaskRetryCount especificado