LogoLogo
  • Welcome to Quantum Cloud Services
  • Getting Started
    • Set up your environment
      • JupyterLab IDE
      • Install Locally
        • Quil SDK Docker Image
    • Quil SDK Overview
    • Running your first Quantum Program
  • Guides
    • Quil
      • What is Quil?
      • Language Support
      • Dynamic Control Flow
      • Customizing Program Readout
    • QPU vs. Simulator (QVM)
    • How to Use Rigetti QPUs
    • Access a QPU
      • QPU Reservations
      • On-Demand Access
      • QCS QPU Gateway
    • QCS Group Accounts
    • Interactive Tutorials
    • How Programs Are Built & Run
      • Execution and Request timeouts
    • The Lifecycle of a Program
    • The Rigetti QCS API
    • Using the QCS CLI
      • Using the Legacy QCS CLI
    • QCS Credentials
    • Benchmarking and Fidelity
  • Troubleshooting
    • Gathering Diagnostics
    • Report an Issue
  • Glossary
  • FAQ
  • References
    • pyQuil Reference
    • QCS API Specification
    • QCS CLI Reference
    • QCS Client Configuration
    • Quil / Quil-T Specification
    • quilc Reference
    • quil-rs Reference
    • QVM Reference
    • Rigetti Module for Cirq
    • Rigetti Provider for Qiskit
Powered by GitBook
On this page
  • Creating a New Group Account
  • Using a Group Account
  • Updating Your Local Configuration Files
  • Using Group Accounts in pyQuil
  • Query Group Account Reservations and Balances

Was this helpful?

  1. Guides

QCS Group Accounts

QCS group accounts provide a means for QCS users to share reservations and billing accounts.

PreviousQCS QPU GatewayNextInteractive Tutorials

Last updated 9 months ago

Was this helpful?

Users may perform actions on behalf of a group, such as:

  • Creating a reservation for the group.

  • Executing a program on a QPU using a group's reservation.

Using a group for these actions allows multiple users to share resources and QPU time amongst each other. In these cases, QCS will bill the shared group account for the reservation and usage rather than the individual user accounts.

Creating a New Group Account

For information about setting up a group account please contact .

Using a Group Account

Updating Your Local Configuration Files

Once you belong to a group account, you can run the following command to add it to your QCS configuration file; this will work anywhere that the is installed.

In the examples below, we will use the string literal "my-group-profile" for a profile name and "my-group" for a group name.

In practice, you can name your profile whatever you like; we just recommend you use something that is easy to remember and type. The profile name does not necessarily need to be the same between individual members of the same group; it does not need to match the group name.

However, the group is named by the Rigetti support team and cannot be renamed by you. You should not change this value in any way when using it in the contexts below. In contrast to the profile name, the group name will match for all members of the same group.

qcs tools add-group-profile my-group-profile my-group

To confirm the operation successfully saved the new profile to your QCS configuration, you may run the following command:

qcs settings list-profiles

After confirmation, you may set the --profile-name argument on any API command or set the QCS_PROFILE_NAME environment variable to my-group-profile to create a group reservation or a group engagement:

qcs --profile-name my-group-profile api create-reservation # ...
# or...
QCS_PROFILE_NAME=my-group-profile qcs api create-reservation # ...

If you would like to use your group profile by default you may run the following:

qcs settings set default_profile_name my-group-profile

Note, however, that setting the QCS_PROFILE_NAME environment variable will override your default profile name.

Using Group Accounts in pyQuil

In many cases, you will be sending programs to a Rigetti QPU using pyQuil. In order to submit a QPU job on behalf of a group, you can set the QCS_PROFILE_NAME as described above.

QCS_PROFILE_NAME=my-group-profile python my_pyquil_script.py

Note, this feature requires pyQuil >= 3.2.0.

Query Group Account Reservations and Balances

qcs api get-group-balance my-group
qcs api list-group-reservations my-group
qcs api list-group-users my-group

Below are some useful commands related to group accounts; each of these CLI commands has corresponding support in the Python package. You can always use qcs api --help for the latest, non-abridged list of available commands.

qcs_api_client
support@rigetti.com
QCS CLI