Estado do Batch e Códigos de Erro

As operações da API REST para o serviço Batch devolvem códigos de estado HTTP padrão, conforme definido nas Definições de Código de Estado HTTP/1.1.

As operações de API também podem devolver informações de erro adicionais para fornecer ao programador mais informações sobre o erro. Por exemplo, a seguinte resposta de erro indica que um parâmetro de consulta especificado no URI do pedido era inválido e fornece informações adicionais sobre o nome e o valor do parâmetro inválido e o motivo do erro.

{
  "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"
  }]
}

As secções seguintes fornecem listas de códigos de erro para o serviço Batch:

• Códigos de Erro comuns da API REST

• Códigos de Erro do Serviço Batch

• Códigos de Erro de Agendamento de Tarefas/Tarefas

Códigos de Erro comuns da API REST

Os códigos de erro listados na tabela seguinte podem ser devolvidos por uma operação no serviço Batch.

Códigos de Erro do Serviço Batch

Os códigos de erro listados na tabela seguinte podem ser devolvidos por uma operação no serviço Batch.

Códigos de Erro de Agendamento de Tarefas/Tarefas

Se o serviço Batch encontrar um erro ao iniciar uma tarefa num nó, marca a tarefa como concluída. As informações de erro são devolvidas dentro de um failureInfo elemento no corpo de resposta de Listar os ficheiros associados a uma tarefa e Obter informações sobre as APIs de tarefas .

Da mesma forma, se o serviço Batch encontrar um erro ao iniciar a tarefa, marca a tarefa como concluída. Estas informações de erro de agendamento são devolvidas dentro de um schedulingError elemento no corpo de resposta de Obter informações sobre uma tarefa nas APIs do Batch .

A tabela seguinte fornece a lista de categorias para erros de agendamento de tarefas.

Segue-se um exemplo de erro de pré-processamento devolvido pelo serviço Batch.

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

A tabela seguinte fornece a lista de códigos de erro de agendamento de tarefas que podem ser devolvidos pelo serviço Batch.

A tabela seguinte fornece a lista de códigos de erro de agendamento de tarefas que podem ser devolvidos pelo serviço Batch.