タスク開始イベント

  • [アーティクル]

スケジューラがコンピューティング ノードでタスクの開始予定を設定すると、このイベントが生成されます。 タスクが再試行またはキューに再び追加されると、このイベントは同じタスクに再度生成されますが、これにより再試行回数とシステム タスクのバージョンは更新されますのでご注意ください。

次の例は、タスク開始イベントの本文を示しています。

{
    "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
    }
}
要素名 Type Notes
jobId String タスクを含むジョブの ID です。
id String タスクの ID です。
taskType String タスクの型です。 ジョブ マネージャー タスクを示す 'JobManager' と、ジョブ マネージャー タスクでないことを示す 'User' のいずれかです。
systemTaskVersion Int32 これは、タスクの内部再試行カウンターです。 Batch サービスは一時的問題に対応するタスクを内部で再試行できます。 これらの問題には、内部的なスケジュール エラーや、コンピューティング ノードを異常な状態から回復しようとする動作が含まれます。
requiredSlots Int32 タスクを実行するために必要なスロット。
nodeInfo 複合型 タスクが実行されたコンピューティング ノードに関する情報が含まれます。
multiInstanceSettings 複合型 このタスクが複数の計算ノードを必要とする、マルチインスタンス タスクであることを指定します。 詳細は multiInstanceSettings をご覧ください。
constraints 複合型 このタスクに適用される実行の制約。
executionInfo 複合型 タスクの実行に関する情報が含まれます。

nodeInfo

要素名 Type Notes
poolId String タスクが実行されたプールの ID。
nodeId String タスクが実行されたノードの ID。

multiInstanceSettings

要素名 Type メモ
numberOfInstances int タスクに必要なコンピューター ノードの数。

constraints

要素名 Type メモ
maxTaskRetryCount Int32 タスクを再試行できる最大回数。 Batch サービスは、終了コードが 0 以外の場合にタスクを再試行します。

この値によって再試行の回数が限定されますのでご注意ください。 Batch サービスはタスクを 1 回試行してから、上限に達するまで再試行できます。 たとえば、最大再試行回数が 3 の場合、Batch はタスクを最大 4 回試行します (初回試行 1 回と再試行 3 回)。

最大再試行回数が 0 の場合、Batch サービスはタスクを再試行しません。

最大再試行回数が -1 の場合、Batch サービスはタスクを無制限に再試行します。

既定値は 0 (再試行なし) です。

executionInfo

要素名 Type メモ
retryCount Int32 Batch サービスによりタスクが再試行された回数。 タスクは、0 以外のコードで終了すると、指定された MaxTaskRetryCount まで再試行されます。