次の方法で共有


タスク完了イベント

このイベントは、終了コードに関係なく、タスクが完了すると生成されます。 このイベントを使用して、タスクの期間、タスクが実行された場所、再試行されたかどうかを判断できます。

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

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

nodeInfo

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

multiInstanceSettings

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

制約

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

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

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

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

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

executionInfo

要素名 タイプ 注記
startTime 日付と時間 タスクの実行が開始された時刻。 'Running' は 実行中 の状態に対応するため、タスクでリソース ファイルまたはアプリケーション パッケージが指定されている場合、開始時刻には、タスクがこれらのリソース ファイルまたはアプリケーション パッケージのダウンロードまたはデプロイを開始した時刻が反映されます。 タスクが再起動または再試行された場合、これはタスクの実行を開始した最新の時刻です。
endTime 日付と時間 タスクが完了した時刻。
exitCode Int32 タスクの終了コード。 タスクが実行を開始する前に失敗した場合、exitCode は null になります。
retryCount Int32 Batch サービスがタスクを再試行した回数。 タスクは、指定された MaxTaskRetryCount まで、0 以外の終了コードで終了した場合に再試行されます。
requeueCount Int32 Batch サービスがユーザー要求の結果としてタスクを再キューした回数。

(サイズ変更または縮小によって) ノードがプールから削除された場合、またはジョブが無効になっている場合は、それらのノードで実行中のタスクを再キューに入れ直すことができます。 この数は、これらの理由からタスクが再キューされた回数を追跡します。
result タスクの結果文字列。"Success" または "Failure" である可能性があります。
schedulingError 複合型 エラーに関する詳細情報が含まれています。

schedulingError

要素名 タイプ 注記
category エラー カテゴリ ("UserError" など)。
code エラー コード (例: "FailureExitCode")。
message エラー メッセージ。
details Array エラーの詳細。