Pular para o conteúdo principal
Proton v5

Alterar o status da execução

PUT 
/dataset-run/:datasetRunId/update-status

Marca o status da execução. A automação usa Running no começo, Passed no fim e Failed quando algo dá errado.

  • Failed e Stopped fecham o passo aberto com o mesmo status.
  • Passed, Failed, Stopped e Cancelled são finais: disparam o aviso de fim do lote e, em Failed, a reexecução em caso de erro, quando configurada.
  • Stopped não aceita outro status depois (409). Para parar uma execução de verdade, use PUT /dataset-run/{id}/stop.

Envie o nome do status (status) ou o id (idStatus); com os dois, vale o nome. Use só os status de execução listados em status.

Junto com Failed, o motivo (reason) diz por que a execução falhou, sem mudar o status. Sem motivo, a falha conta como técnica. O status final grava também o fim, a duração e o motivo do fim da execução (finishedAt, durationMs e endReason em GET /dataset-run/{id}). O mesmo status final repetido não muda nada: quando a automação manda Failed com o motivo de negócio e o runner, ao fim do processo, manda Failed de novo sem motivo, o fim e o motivo da automação ficam.

Permissão: Execuções: alterar.

Request​

Responses​

Status alterado. A resposta não tem corpo.