Reserving Time on a QPU
Reserving time on a QPU requires an existing QCS account. If you don't already have a QCS account, you can request one.
There are two ways to reserve time on a Rigetti QPU:
From the QCS dashboard, start by selecting a desired reservation duration, date, and time, then click the search icon.

You'll be presented with a list of available QPUs, including information about each QPU's topology and fidelities. Simply select a desired QPU and follow the confirmation prompts.
Once finished, you'll receive an email confirming the reservation.
To view upcoming reservations, visit the QCS dashboard and scroll down until you see the
Upcoming Reservations
section.From there, click
View all your reservations
to see past and future reservations, or click the trash can icon next to a reservation to cancel it.If you're using the QCS CLI from a local computer instead of your provisioned JupyterLab IDE, ensure you've downloaded and configured the CLI.
This guide refers to the new QCS CLI, made for working with pyQuil v3. If you're using pyQuil v2, refer to Using the Legacy QCS CLI.
First, view a list of available QPUs:
qcs api list-quantum-processors
If you'd like to inspect the topology and fidelity information for a QPU, you can use
qcs api get-instruction-set-architecture <quantum-processor-id>
.For example, to inspect
Aspen-9
, run:qcs api get-instruction-set-architecture Aspen-9
Once you've selected a QPU, interactively select an available reservation with the
qcs tools reserve
command.For example, to book a reservation on
Aspen-9
, run:qcs tools reserve --quantum-processor-id Aspen-9
There are more options available to this command than shown above. See the QCS CLI reference for more details.
Once finished, you'll receive an email confirming the reservation.
To list reservations, run:
qcs api list-reservations
The above command will list all reservations, past and future. If you'd like to filter based on properties like QPU or start time, you can supply a
--filter
option.For example:
qcs api list-reservations --filter 'quantumProcessorId = "Aspen-9"'
qcs api list-reservations --filter 'startTime >= "2021-05-13T00:00:00Z"'
To cancel an upcoming reservation, run the following command (supplying the ID for the reservation in place of
<reservation-id>
):qcs api delete-reservation <reservation-id>
A reservation's ID can be found by looking at the
id
field in the results of running qcs api list-reservations
, as described above.Last modified 22d ago