Bulk API 2.0 and Bulk API Developer Guide
jNewer Version Available
Interpret Batch State
This list gives you more details about the various states, also known as statuses, of a
batch. The batch state informs you whether to proceed to get the results, or whether you must wait
or fix errors related to your request.
- Queued
- Processing of the batch hasn’t started yet. If the job associated with this batch is aborted, the batch isn’t processed and its state is set to NotProcessed.
- InProgress
- The batch is being processed. If the job associated with the batch is aborted, the batch is still processed to completion. You must close the job associated with the batch so that the batch can finish processing.
- Completed
- The batch has been processed completely, and the result resource is available. The result resource indicates if some records failed. A batch can be completed even if some or all the records failed. If a subset of records failed, the successful records aren’t rolled back.
- Failed
- The batch failed to process the full request due to an unexpected error, such as the request is compressed with an unsupported format, or an internal server error. Even if the batch failed, some records could have completed successfully. If the numberRecordsProcessed field in the response is greater than zero, you should get the results to see which records were processed, and if they were successful.
- NotProcessed
- The batch won’t be processed. This state is assigned when a job is aborted while the batch is queued. For bulk queries, if the job has PK chunking enabled, this state is assigned to the original batch that contains the query when the subsequent batches are created. After the original batch is changed to this state, you can monitor the subsequent batches and retrieve each batch’s results when it’s completed.