Skip to content

how-to-create-workspace.md

Latest commit

 

History

History
112 lines (72 loc) · 7.04 KB

how-to-create-workspace.md

File metadata and controls

112 lines (72 loc) · 7.04 KB
Raw
author azure-quantum-content
description Learn about the different subscription plans available in Azure and how to create an Azure Quantum workspace.
ms.author quantumdocwriters
ms.date 03/26/2025
ms.service azure-quantum
ms.subservice qdk
ms.topic how-to
no-loc
Q#
$$v
target
targets
title Create an Azure Quantum workspace
uid microsoft.quantum.how-to.workspace

Create an Azure Quantum workspace

Learn how to create an Azure Quantum workspace in the Azure portal. An Azure Quantum workspace resource, or workspace for short, is a collection of assets associated with running quantum applications.

You need a workspace to submit quantum programs to quantum hardware.

Tip

You can also create an Azure Quantum workspace using the Azure command-line interface (CLI). For more information, see Manage quantum workspaces with the Azure CLI.

Prerequisites

You need to have an Azure account with an active subscription to create an Azure Quantum workspace. If you don't have one, you can choose from one of the following subscriptions, or for a full list see Microsoft Azure Offer Details.

Azure subscription Description
Pay-as-you-go (recommended) You pay for the services you use, and you can cancel anytime.
Enterprise Agreement If your organization has an Enterprise Agreement (EA) purchasing contract with Microsoft, your organization's Account Owners can create Enterprise Dev/Test subscriptions for active Visual Studio subscribers under the EA.

If you have questions or run into issues when you use Azure Quantum, then contact AzureQuantumInfo@microsoft.com.

Create the workspace

To create an Azure Quantum workspace, follow these steps.

  1. Sign in to the Azure portal, using the credentials for your Azure subscription.

  2. Select Create a resource and then search for Azure Quantum. On the results page, you should see a tile for the Azure Quantum service.

  3. Select Azure Quantum, and then select Create. The workspace creation form opens.

  4. Select a subscription to associate with the new workspace.

  5. Select Quick create or Advanced create.

Quick create

This option is the easiest path to creating a workspace. It automatically creates the necessary resource group and storage account, adds the IonQ, Quantinuum, Rigetti, and Microsoft Quantum Computing providers. Your workspace can still be customized after creation, if needed.

Note

To use Quick create, you must be an Owner of the subscription you selected in the previous step. To see a list of your subscriptions and access, see Check your role assignments.

  1. Enter a name for the workspace.
  2. Select the region for the workspace.
  3. Select Create.

Note

If you encounter issues during deployment, see Azure Quantum common issues: Creating an Azure Quantum workspace.

Advanced create

Use this option to manually configure your resource group and storage account, select other payment options for your providers, and set tags to categorize resources. By default, this option also adds the IonQ, Quantinuum, Rigetti, and Microsoft Quantum Computing providers.

Note

If you're unable to create or select a resource group or storage account as described in the following steps, then you may not have the access required at the subscription, resource group, or storage account level. For more information on authorization, see Role requirements for creating a workspace.

  1. Select an existing resource group or create a new one.

  2. Enter a name for the workspace.

  3. Select the region for the workspace.

  4. Select or create a storage account for the workspace:

    • To have Azure automatically create a storage account, select Use a managed storage account with default settings (recommended).
    • To use an existing storage account in your subscription or to create a new one manually, select Customize storage account settings (advanced).

    [!NOTE] The storage account you select must be enabled for public internet access. For more information, see Authorization failure.

  5. Select Next.

  6. A list of providers are automatically added to the workspace. To add another available provider, select Add on that provider's tile. To modify the pricing plan for any of the selected providers, select Modify.

    [!NOTE] Pricing for Azure Quantum varies by provider. Consult the information in the Providers tab of your Azure Quantum workspace in the Azure portal for the most up-to-date pricing information, or visit the Azure Quantum pricing page.

  7. Select Next.

  8. To add optional tags to your workspace, enter a name/value pair, or select Next.

  9. Review the settings that you selected and, if everything is correct, select Create to create your workspace.

Deployment of your workspace may take a few minutes. The portal updates the status and deployment details.

Note

If you run into any issues, see Azure Quantum common issues: Creating an Azure Quantum workspace.