least_busy

least_busy(backends)[source]

Return the least busy backend from a list.

Return the least busy available backend for those that have a pending_jobs in their status. Note that local backends may not have this attribute.

Parameters

backends (List[BaseBackend]) – The backends to choose from.

Return type

BaseBackend

Returns

The backend with the fewest number of pending jobs.

Raises

IBMQError – If the backends list is empty or if a backend in the list does not have the pending_jobs attribute in its status.