バッチの状態とエラー コード

Batch サービスの REST API 操作では、 HTTP/1.1 状態コード定義で定義されている標準の HTTP 状態コードが返されます。

API 操作では、追加のエラー情報を返して、開発者にエラーの詳細を提供する場合もあります。 たとえば、次のエラー応答は、要求 URI で指定されたクエリ パラメーターが無効であったことを示し、さらに追加のエラー情報として、無効なパラメーターの名前と値およびエラーの理由を示しています。

{
  "code": "InvalidQueryParameterValue",
  "message": {
      "lang": "en-us",
      "value": "Value for one of the query parameters specified in the request URI is invalid"
  },
  "values": [{
      "key": "QueryParameterName",
      "value": "state"
  }, {
      "key": "QueryParameterValue",
      "value": "deleted"
  }, {
      "key": "Reason",
      "value": "invalid state"
  }]
}

次のセクションでは、バッチ サービスのエラー コードの一覧を示します。

• REST API の一般的なエラー コード

• バッチ サービスのエラー コード

• ジョブとタスクのスケジューリングに関するエラー コード

REST API の一般的なエラー コード

バッチ サービスに対して操作を実行した結果、返される可能性があるエラー コードを次の表に示します。

バッチ サービスのエラー コード

バッチ サービスに対して操作を実行した結果、返される可能性があるエラー コードを次の表に示します。

ジョブとタスクのスケジューリングに関するエラー コード

Batch サービスは、ノードでタスクを開始するときにエラーが発生した場合、タスクを完了としてマークします。 エラー情報は、タスクに関連付けられているファイルのfailureInfo一覧表示とタスク API に関する情報の取得の応答本文の要素内で返されます。

同様に、バッチ サービスがジョブの開始中にエラーを検出した場合、そのジョブには完了済みのマークが付けられます。 このスケジュール エラー情報は、Batch API のジョブに関する情報を取得するの応答本文の要素内schedulingErrorで返されます。

次の表は、タスク スケジューリング エラーのカテゴリの一覧を示しています。

Batch サービスによって返される前処理エラーの例を次に示します。

{
  "preProcessingError": {
    "category": "UserError",
    "code": "BlobNotFound",
    "message": "The specified blob does not exist.",
    "values": {
      "name": "FilePath",
      "value": "myfile.txt"
    }
  }
}

次の表に、Batch サービスによって返される可能性があるジョブ スケジュール エラー コードの一覧を示します。

次の表に、Batch サービスによって返される可能性があるタスク スケジュール エラー コードの一覧を示します。