Expose session details

[nonhermitian]

What is the expected feature or enhancement?

An user should be able to query for the remaining session time from a session instance. In addition, it'd also be useful to know about session status, and what the various TTLs are.

Acceptance criteria

• Expose session details, including
  • backend name
  • created/updated/started/closed timestamps
  • last job start/complete
  • interactive ttl (map to interactive_timeout)
  • max ttl (map to max_time to match session parameter)
  • state (should map to open, closed (not accepting job, see this issue), and cancelled)
• Doc update

[kt474]

@merav-aharoni you can see how these session details are exposed here. Currently, this is only supported on the cloud channel. We can start working on this issue, but should wait until this is also supported on the iqp side before merging.

You can also see @kvcmarshall's helpful screen shots in her PR on the server side (ntc 3052)

Waiting on sw-api-iqp PR's 418 and 411

There are more details in ws-qiskit-runtime-api issue 247

Something to keep in mind with this, and I'm not sure how Qiskit works with this, but the GET /sessions/:id API is only being implemented in the ntc and sw-api-iqp (new job service) repos, not the ntc-iqp-channel fork. The ntc repo is deployed for cloud pay-go and IQP DE (Fraunhofer). The sw-api-iqp service is only going to be deployed in the US.

So Qiskit may need to account for those wrinkles when forming a request depending on the base URL. Like, if I'm using qiskit-ibm-runtime and the channel is quantum then in the US it'll be talking to sw-api-iqp but in DE it'd be talking to ntc, will Qiskit know how to form the URLs properly?

If this is the case, we can try using try/except and return None if it's not supported.

[jyu00]

@beckykd we should also update session docs once this is done - e.g. under session time limits we can show code to query the data.

[mriedem]

For IQP (quantum channel) the API is here: https://api.quantum-computing.ibm.com/runtime/api#/sessions/GetSessionDetailsController_sendAcceptingJobs