qrisp.interface.Backend.retrieve_job#

Backend.retrieve_job(job_id: str) → Job[source]#

Reconnect to a previously submitted job by its identifier.

This method allows users to recover a Job handle after a process restart or network interruption, provided the backend stores job history server-side.

This is an optional capability. The default implementation raises NotImplementedError. Backends that support job recovery must override this method.

Parameters:

job_idstr: The identifier of the job to retrieve. This is the value returned by Job.job_id after a previous call to run_async().

Returns:

Job: A handle to the previously submitted job, in whatever state it currently is.

Raises:

NotImplementedError: If this backend does not support job recovery (the default).
LookupError: If no job with the given job_id can be found on the backend.