153 lines
6.1 KiB
Plaintext
153 lines
6.1 KiB
Plaintext
---
|
||
title: JobV1 (latest version)
|
||
description: API reference for qiskit.providers.JobV1 in the latest version of qiskit
|
||
in_page_toc_min_heading_level: 1
|
||
python_api_type: class
|
||
python_api_name: qiskit.providers.JobV1
|
||
---
|
||
|
||
# JobV1
|
||
|
||
<Class id="qiskit.providers.JobV1" isDedicatedPage={true} github="https://github.com/Qiskit/qiskit/tree/stable/1.2/qiskit/providers/job.py#L42-L147" signature="qiskit.providers.JobV1(backend, job_id, **kwargs)" modifiers="class">
|
||
Bases: [`Job`](qiskit.providers.Job "qiskit.providers.job.Job"), [`ABC`](https://docs.python.org/3/library/abc.html#abc.ABC "(in Python v3.13)")
|
||
|
||
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*](qiskit.providers.Backend "qiskit.providers.Backend")*]*) – the backend used to run the job.
|
||
* **job\_id** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.13)")) – 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
|
||
|
||
<Attribute id="qiskit.providers.JobV1.version" attributeValue="1" />
|
||
|
||
## Methods
|
||
|
||
### backend
|
||
|
||
<Function id="qiskit.providers.JobV1.backend" github="https://github.com/Qiskit/qiskit/tree/stable/1.2/qiskit/providers/job.py#L72-L76" signature="backend()">
|
||
Return the backend where this job was executed.
|
||
|
||
**Return type**
|
||
|
||
[*Backend*](qiskit.providers.Backend "qiskit.providers.backend.Backend")
|
||
</Function>
|
||
|
||
### cancel
|
||
|
||
<Function id="qiskit.providers.JobV1.cancel" github="https://github.com/Qiskit/qiskit/tree/stable/1.2/qiskit/providers/job.py#L140-L142" signature="cancel()">
|
||
Attempt to cancel the job.
|
||
</Function>
|
||
|
||
### cancelled
|
||
|
||
<Function id="qiskit.providers.JobV1.cancelled" github="https://github.com/Qiskit/qiskit/tree/stable/1.2/qiskit/providers/job.py#L86-L88" signature="cancelled()">
|
||
Return whether the job has been cancelled.
|
||
|
||
**Return type**
|
||
|
||
[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.13)")
|
||
</Function>
|
||
|
||
### done
|
||
|
||
<Function id="qiskit.providers.JobV1.done" github="https://github.com/Qiskit/qiskit/tree/stable/1.2/qiskit/providers/job.py#L78-L80" signature="done()">
|
||
Return whether the job has successfully run.
|
||
|
||
**Return type**
|
||
|
||
[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.13)")
|
||
</Function>
|
||
|
||
### in\_final\_state
|
||
|
||
<Function id="qiskit.providers.JobV1.in_final_state" github="https://github.com/Qiskit/qiskit/tree/stable/1.2/qiskit/providers/job.py#L90-L92" signature="in_final_state()">
|
||
Return whether the job is in a final job state such as `DONE` or `ERROR`.
|
||
|
||
**Return type**
|
||
|
||
[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.13)")
|
||
</Function>
|
||
|
||
### job\_id
|
||
|
||
<Function id="qiskit.providers.JobV1.job_id" github="https://github.com/Qiskit/qiskit/tree/stable/1.2/qiskit/providers/job.py#L68-L70" signature="job_id()">
|
||
Return a unique id identifying the job.
|
||
|
||
**Return type**
|
||
|
||
[str](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.13)")
|
||
</Function>
|
||
|
||
### result
|
||
|
||
<Function id="qiskit.providers.JobV1.result" github="https://github.com/Qiskit/qiskit/tree/stable/1.2/qiskit/providers/job.py#L135-L138" signature="result()" modifiers="abstract">
|
||
Return the results of the job.
|
||
|
||
**Return type**
|
||
|
||
[Result](qiskit.result.Result "qiskit.result.Result")
|
||
</Function>
|
||
|
||
### running
|
||
|
||
<Function id="qiskit.providers.JobV1.running" github="https://github.com/Qiskit/qiskit/tree/stable/1.2/qiskit/providers/job.py#L82-L84" signature="running()">
|
||
Return whether the job is actively running.
|
||
|
||
**Return type**
|
||
|
||
[bool](https://docs.python.org/3/library/functions.html#bool "(in Python v3.13)")
|
||
</Function>
|
||
|
||
### status
|
||
|
||
<Function id="qiskit.providers.JobV1.status" github="https://github.com/Qiskit/qiskit/tree/stable/1.2/qiskit/providers/job.py#L144-L147" signature="status()" modifiers="abstract">
|
||
Return the status of the job, among the values of `JobStatus`.
|
||
|
||
**Return type**
|
||
|
||
[*JobStatus*](qiskit.providers.JobStatus "qiskit.providers.jobstatus.JobStatus")
|
||
</Function>
|
||
|
||
### submit
|
||
|
||
<Function id="qiskit.providers.JobV1.submit" github="https://github.com/Qiskit/qiskit/tree/stable/1.2/qiskit/providers/job.py#L130-L133" signature="submit()" modifiers="abstract">
|
||
Submit the job to the backend for execution.
|
||
</Function>
|
||
|
||
### wait\_for\_final\_state
|
||
|
||
<Function id="qiskit.providers.JobV1.wait_for_final_state" github="https://github.com/Qiskit/qiskit/tree/stable/1.2/qiskit/providers/job.py#L94-L128" signature="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*](https://docs.python.org/3/library/functions.html#float "(in Python v3.13)") *| None*) – Seconds to wait for the job. If `None`, wait indefinitely.
|
||
|
||
* **wait** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.13)")) – Seconds between queries.
|
||
|
||
* **callback** ([*Callable*](https://docs.python.org/3/library/typing.html#typing.Callable "(in Python v3.13)") *| 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**](providers#qiskit.providers.JobTimeoutError "qiskit.providers.JobTimeoutError") – If the job does not reach a final state before the specified timeout.
|
||
</Function>
|
||
</Class>
|
||
|