Migrate your Azure Quantum job data

If you have an existing Azure Quantum workspace and you create new workspace, then you can migrate your job data from the old workspace to the new workspace. When you do the migration, your job input and output data are available in your new workspace. But you can't see the job history for those jobs anymore in the Azure portal, Azure Quantum SDK, or the Azure CLI.

Migration instructions depend on whether the existing Azure Quantum workspace uses managed or unmanaged storage:

• An unmanaged workspace uses a user‑specified Azure Storage account that already exists and is explicitly selected during workspace creation.
• A managed workspace uses a storage account that Azure automatically creates and manages as part of the workspace.

Important

Don't delete your old workspace until after you migrate your data to your new workspace. Before you migrate your job data, make sure that you don't have open jobs in the queue. To remove an open job from the queue, either wait for the job to finish running or cancel the job.

Unmanaged storage

If your old workspace uses an unmanaged storage account, then link that storage account to your new workspace. The linked storage account contains your old job data along with data for jobs that you submit in your new workspace.

Note

To link a storage account to a Quantum workspace, you must have a role assignment that allows you to perform role assignments on that storage account, such as Owner or User Access Administrator.

To create a new Quantum workspace and link your storage account, follow these steps:

1. Sign in to the Azure portal, go to Quantum Workspaces, and then choose Create.
2. Choose your subscription in the Subscription dropdown list, and then select Advanced create.
3. In the Project details section, open the Resource group dropdown list and choose the resource group that contains the storage account for your old workspace.
4. In the Instance details section, enter a name for your new workspace in the Workspace name field, and then choose one of the supported regions from the Region dropdown list (East US, West US, North Europe, or West Europe).
5. For Data Storage, choose Customize storage account settings (advanced). A Storage Account dropdown list appears that contains all the storage accounts in your selected resource group. Choose the storage account ID for your old workspace's storage account.
6. To review your workspace settings, choose Review + create. Or, choose Next: Providers > to customize your provider and plan options, and then choose Next: Tags > to add tags to your workspace.
7. Verify that all your workspace settings are correct, and then choose Create.

The storage account for your old workspace is now associated with your new workspace, and all job history is retained in that storage account.

Managed storage

If your old workspace uses a managed storage account, then create a new workspace with a managed storage account and use AzCopy to migrate your data from the old managed storage account to the new managed storage account. For information about how to install and use AzCopy, see Get started with AzCopy.

Note

To use AzCopy to migrate your job data to a new managed storage account, you must have a role assignment in each storage account that allows you to generate a shared access signature (SAS), such as Contributor or Storage Account Contributor.

Create a new Quantum workspace with a managed storage account

To create a new workspace with a managed storage account, follow these steps:

1. Sign in to the Azure portal, go to Quantum Workspaces, and then choose Create.
2. Choose your subscription in the Subscription dropdown list, and then select Advanced create.
3. In the Project details section, open the Resource group dropdown list and choose a resource group for your new workspace.
4. In the Instance details section, enter a name for your new workspace in the Workspace name field, and then choose one of the supported regions from the Region dropdown list (East US, West US, North Europe, or West Europe).
5. For Data Storage, choose Use a managed storage account with default settings (recommended).
6. To review your workspace settings, choose Review + create. Or, choose Next: Providers > to customize your provider and plan options, and then choose Next: Tags > to add tags to your workspace.
7. Verify that all the workspace settings are correct, and then choose Create.

Use AzCopy to migrate your data

You can't link your old workspace's managed storage account to your new workspace, but you can use AzCopy to copy the job data from your old managed storage account to your new managed storage account. To use AzCopy to migrate your job data, generate a SAS for each storage account.

To generate a SAS for each storage account, follow these steps:

1. Sign in to the Azure portal, go to Quantum Workspaces, and then choose your old workspace.

2. In the Overview menu, choose the Storage account link.

3. In the Security + networking dropdown on the Storage account blade, choose Shared access signature.

4. For Allowed services, select only Blob.

   For Allowed resource types, select Service, Container, and Object.

   For Allowed permissions, make sure that you select Read and List.

5. To generate a SAS for your old workspace's storage account, choose Generate SAS and connection string. Copy and save the Blob service SAS URL text. You need this URL when you use AzCopy.

6. To generate a SAS for your new workspace's storage account, go to Quantum Workspaces again, choose your new workspace, and then repeat the preceding steps. The only difference for the new workspace SAS is the allowed permissions.

   For Allowed permissions, make sure that you select Write, Add, and Create. Copy and save the URL for this SAS too.

7. Open a terminal and run the following AzCopy command:

   azcopy copy <old storage account blob service SAS URL> <new storage account blob service SAS URL> --recursive
   

If the copy is successful, then you get a job summary output in the terminal. The contents of your old managed storage account are now also in your new managed storage account.

Note

For questions about migration issues, email azurequantuminfo@microsoft.com.