Today batch_jobs returns a counts of the jobs in the running state and an aggregate count of the jobs in the completed, cancelled and crashed states. It also returns a list of ids of finished jobs in the batch.

This method should be updated to match the formal states defined in #960. The list of job ids should also be removed from the output. This way it's possible to check the status of a batch without getting a large response, and the job ids are available from the batch_domains method when you need them.

Outputs parameters to remove:

• The number of finished tests.
• The list of job ids of finished jobs in this batch.

Outputs parameters to add:

• waiting_count - A non-negative integer. The number of waiting jobs in the batch.
• completed_count - A non-negative integer. The number of completed jobs in the batch.
• cancelled_count - A non-negative integer. The number of cancelled jobs in the batch.
• crashed_count - A non-negative integer. The number of crashed jobs in the batch.

Stabilization

Tracking issue

Affected interfaces

Incompatibly changed:

• batch_status

Dependencies

• This proposal depends on Formal states for test items #960.

Overlapping proposals

• This proposal is basically just an updated version of the get_batch_status method from Updated API methods for batches #1119 that's been renamed, adapted to Formal states for test items #960 and simplified. I feel there are too many ideas in Updated API methods for batches #1119 and it's better to split this part out to its own issue.