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[Backend]) – The backends to choose from.

Return type:

Backend

Returns:

The backend with the fewest number of pending jobs.

Raises:

IBMError – If the backends list is empty, or if none of the backends is available, or if a backend in the list does not have the pending_jobs attribute in its status.