...
Status | Meaning |
|---|---|
Waiting | Batch has been created but no page has been picked up yet |
Processing | At least one page of the batch is already processing |
Completed | All records have been processed and there was no failure for any record |
CompletedWithErrors | All records have been processed and there was at 1 failure for a record |
PostBatchFailed | All records have been processed but in the post batch step an exception occured. |
TooManyFailed | At 20% of records encountered a failure and the batch was aborted as a consequence |
Cancellling | A request has been sent to cancel the batch. No new jobs will be created. |
Cancelled | Status after all the existing jobs of the batch are finished after cancelling. |
API Permissions
POST batches/
...
Function | Effect |
|---|---|
No | Can read the batches created by this user |
| Can read all the batches from the index of the organisation of this user |
| Can read all batches from all indices |
PATCH batches/
Following functions are needed to partially update a batch:
Function | When needed? |
|---|---|
| Own batches |
| Batches from the same organisation |
| Batches from other organisations |
DELETE batches/
For cancelling a batch you need the same functions as for PATCH
Cleanup 24.2+
Completed batches are cleaned up 30 days after their finish date.
...
Normally, a batch is executed on the index of the organization to which the user belongs. When a batch is started by the zeticon@installation or system@installation user, it will be executed across all indices available on the system.
Cancellation 24.3+
A batch can be cancelled by sending a DELETE request, which sets the status to Cancelling. The cancellation is not an instant process, but instead, it will let the existing jobs of the batch finish. No new jobs will be created. After the jobs are finished, the status is set to Cancelled.