Add instance property to job (#1771)

* Add instance property to job

* Add release note

* add test

* assertEqual instead of True

* Update docstring

qiskit_ibm_runtime/base_runtime_job.py

@@ -468,6 +468,13 @@ def usage_estimation(self) -> Dict[str, Any]:
 
         return self._usage_estimation
 
+    @property
+    def instance(self) -> Optional[str]:
+        """For ibm_quantum channel jobs, return the instance where the job was run.
+        For ibm_cloud, `None` is returned.
+        """
+        return self._backend._instance
+
     @abstractmethod
     def in_final_state(self) -> bool:
         """Return whether the job is in a final job state such as ``DONE`` or ``ERROR``."""

release-notes/unreleased/1771.feat.rst

@@ -0,0 +1,2 @@
+Added an ``instance`` property to :class:`BaseRuntimeJob` which returns the instance
+where the job was run.

test/integration/test_ibm_job_attributes.py

@@ -63,6 +63,10 @@ def test_job_id(self):
         """Test getting a job ID."""
         self.assertTrue(self.sim_job.job_id() is not None)
 
+    def test_job_instance(self):
+        """Test getting job instance."""
+        self.assertEqual(self.dependencies.instance, self.sim_job.instance)
+
     def test_get_backend_name(self):
         """Test getting a backend name."""
         self.assertTrue(self.sim_job.backend().name == self.sim_backend.name)