Migrate your Azure Quantum job data

If your old workspace uses an unmanaged storage account, then link that storage account to your new workspace. Your old job data will be available in your new workspace because the linked storage account already contains your old job data.

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

1. Log 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.

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.

Create a new Quantum workspace with a managed storage account

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

1. Log 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. Log 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.