次の方法で共有

タスク スケジュール失敗イベント

このイベントは、タスクがスケジュールに失敗し、後で再試行されたときに生成されます。 リソースの制限により、タスクのスケジュール時に一時的なエラーになります。たとえば、 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 糸 タスクを含むジョブの ID。
id 糸 タスクの ID です。
taskType 糸 タスクの種類。 ジョブ マネージャー タスクであることを示す "JobManager" か、ジョブ マネージャー タスクではないことを示す "ユーザー" です。 このイベントは、ジョブ準備タスク、ジョブ解放タスク、または開始タスクには出力されません。
systemTaskVersion Int32 タスクの内部再試行カウンター。 内部的には、Batch サービスはタスクを再試行して、一時的な問題を考慮することができます。 これらの問題には、内部スケジュール エラーや、不適切な状態のコンピューティング ノードからの復旧の試行が含まれる場合があります。
requiredSlots Int32 タスクを実行するために必要なスロット。
nodeInfo 複合型 タスクが実行されたコンピューティング ノードに関する情報が含まれます。
multiInstanceSettings 複合型 タスクが複数のコンピューティング ノードを必要とするマルチインスタンス タスクであることを指定します。 詳細については、multiInstanceSettings を参照してください。
constraints 複合型 このタスクに適用される実行制約。
schedulingError 複合型 タスクのスケジュール エラーに関する情報が含まれています。

nodeInfo

要素名 タイプ 注記
poolId 糸 タスクが実行されたプールの ID。
nodeId 糸 タスクが実行されたノードの ID。

multiInstanceSettings

要素名 タイプ 注記
numberOfInstances Int32 タスクに必要なコンピューティング ノードの数。

制約

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

この値は、再試行回数を具体的に制御します。 Batch サービスはタスクを 1 回試行し、この制限まで再試行できます。 たとえば、最大再試行回数が 3 の場合、Batch はタスクを最大 4 回試行します (1 回の最初の再試行と 3 回の再試行)。

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

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

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

schedulingError

要素名 タイプ 注記
category 糸 エラーのカテゴリ。
code 糸 タスク スケジュール エラーの識別子。 コードは不変であり、プログラムで使用することを目的としています。
message 糸 ユーザー インターフェイスでの表示に適したタスク スケジュール エラーを説明するメッセージ。