JobV1
qiskit.providers.JobV1(backend, job_id, **kwargs)
Bases: Job
, ABC
(opens in a new tab)
Class to handle jobs
This first version of the Backend abstract class is written to be mostly backwards compatible with the legacy providers interface. This was done to ease the transition for users and provider maintainers to the new versioned providers. Expect, future versions of this abstract class to change the data model and interface.
Initializes the asynchronous job.
Parameters
- backend (Optional[Backend]) – the backend used to run the job.
- job_id (str(opens in a new tab)) – a unique id in the context of the backend used to run the job.
- kwargs – Any key value metadata to associate with this job.
Attributes
version
Default value: 1
Methods
backend
backend()
cancel
cancelled
cancelled()
done
in_final_state
in_final_state()
Return whether the job is in a final job state such as DONE
or ERROR
.
Return type
job_id
job_id()
result
running
running()
status
abstract status()
submit
wait_for_final_state
wait_for_final_state(timeout=None, wait=5, callback=None)
Poll the job status until it progresses to a final state such as DONE
or ERROR
.
Parameters
-
timeout (float(opens in a new tab) | None) – Seconds to wait for the job. If
None
, wait indefinitely. -
wait (float(opens in a new tab)) – Seconds between queries.
-
callback (Callable(opens in a new tab) | None) –
Callback function invoked after each query. The following positional arguments are provided to the callback function:
- job_id: Job ID
- job_status: Status of the job from the last query
- job: This BaseJob instance
Note: different subclass might provide different arguments to the callback function.
Raises
JobTimeoutError – If the job does not reach a final state before the specified timeout.