Skip to main contentIBM Quantum Documentation

BasicProviderJob

qiskit.providers.basic_provider.BasicProviderJob(backend, job_id, result)

GitHub(opens in a new tab)

Bases: JobV1

BasicProviderJob class.

Initializes the asynchronous job.

Parameters

  • backend – the backend used to run the job.
  • job_id – 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()

GitHub(opens in a new tab)

Return the instance of the backend used for this job.

cancel

cancel()

GitHub(opens in a new tab)

Attempt to cancel the job.

cancelled

cancelled()

GitHub(opens in a new tab)

Return whether the job has been cancelled.

Return type

bool(opens in a new tab)

done

done()

GitHub(opens in a new tab)

Return whether the job has successfully run.

Return type

bool(opens in a new tab)

in_final_state

in_final_state()

GitHub(opens in a new tab)

Return whether the job is in a final job state such as DONE or ERROR.

Return type

bool(opens in a new tab)

job_id

job_id()

GitHub(opens in a new tab)

Return a unique id identifying the job.

Return type

str(opens in a new tab)

result

result(timeout=None)

GitHub(opens in a new tab)

Get job result .

Returns

Result object

Return type

qiskit.result.Result

running

running()

GitHub(opens in a new tab)

Return whether the job is actively running.

Return type

bool(opens in a new tab)

status

status()

GitHub(opens in a new tab)

Gets the status of the job by querying the Python’s future

Returns

The current JobStatus

Return type

qiskit.providers.JobStatus

submit

submit()

GitHub(opens in a new tab)

Submit the job to the backend for execution.

Raises

JobError – if trying to re-submit the job.

wait_for_final_state

wait_for_final_state(timeout=None, wait=5, callback=None)

GitHub(opens in a new tab)

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.

Was this page helpful?
Report a bug or request content on GitHub.