Verbinding maken met uw Azure Quantum-werkruimte met de QDK of Azure CLI

Als u een Azure Quantum werkruimte hebt, kunt u verbinding maken met uw werkruimte en uw code verzenden met de qdk.azure Python-module. De qdk.azure module biedt een Workspace klasse die een Azure Quantum-werkruimte vertegenwoordigt.

Vereisten

Als u verbinding wilt maken met uw werkruimte met de qdk.azure module, hebt u het volgende nodig:

  • Een Azure-account met een actief abonnement. Als u geen Azure-account hebt, registreert u zich gratis en registreert u zich voor een abonnement op basis van betalen per gebruik.

  • Een Azure Quantum-werkruimte. Zie Een Azure Quantum werkruimte maken als u geen werkruimte hebt.

  • De nieuwste versie van het qdk python-pakket met de azure extra.

    pip install --upgrade "qdk[azure]"

Als u Azure CLI gebruikt, werkt u bij naar de nieuwste versie. Zie voor installatie-instructies:

Verbinding maken met een verbindingsreeks

Gebruik een verbindingsreeks om de verbindingsparameters op te geven voor een Azure Quantum werkruimte. Verbindingsreeksen zijn handig in de volgende scenario's:

  • U wilt toegang tot uw werkruimte delen met anderen die geen Azure-account hebben.
  • U wilt de toegang tot uw werkruimte gedurende een beperkte periode delen met anderen.
  • U kunt Microsoft Entra-id niet gebruiken vanwege bedrijfsbeleid.

Tip

Elke Azure Quantum-werkruimte heeft een primaire sleutel en een secundaire sleutel en elke sleutel heeft een eigen verbindingsreeks. Als u anderen toegang wilt geven tot uw werkruimte, deelt u de secundaire sleutel en gebruikt u de primaire sleutel alleen voor uw eigen services. U kunt de secundaire sleutel vervangen zonder downtime in uw eigen services te veroorzaken. Zie Toegang tot uw werkruimte delen voor meer informatie over het delen van toegang tot uw werkruimte.

De verbindingsreeks kopiëren

  1. Meld u aan bij het Azure-portaal.
  2. Ga naar uw Azure Quantum-werkruimte.
  3. Vouw in het werkruimtevenster de vervolgkeuzelijst Bewerkingen uit en selecteer Toegangssleutels.
  4. Schakel toegangssleutels in voor uw werkruimte. Als de schuifregelaar Toegangssleutels is ingesteld op Uitgeschakeld, stelt u de schuifregelaar in op Ingeschakeld.
  5. Selecteer het pictogram Kopiëren voor de verbindingsreeks die u wilt kopiëren. U kunt de primaire of secundaire verbindingsreeks kiezen.

Waarschuwing

Het is een beveiligingsrisico voor het opslaan van toegangssleutels of verbindingsreeksen van uw account in duidelijke tekst. Sla uw accountsleutels op in een versleutelde indeling of migreer uw toepassingen om Microsoft Entra-autorisatie te gebruiken voor toegang tot uw Azure Quantum-werkruimte.

De verbindingsreeks gebruiken om toegang te krijgen tot uw Azure Quantum-werkruimte

Gebruik de verbindingsreeks die u hebt gekopieerd om verbinding te maken met uw Azure Quantum-werkruimte met de qdk.azure-module of de QDK-extensie in Visual Studio Code.

Als u verbinding wilt maken met uw Azure Quantum werkruimte, kiest u een van de volgende methoden.

  • Gebruik de from_connection_string functie om een Workspace object te maken.

    from qdk.azure import Workspace 

connection_string = "" # Add your connection string
workspace = Workspace.from_connection_string(connection_string) 

print(workspace.get_targets())

  • Sla uw verbindingsreeks op in een omgevingsvariabele.

    import os
from qdk.azure import Workspace 

connection_string = "" # Add your connection string  
os.environ["AZURE_QUANTUM_CONNECTION_STRING"] = connection_string 

workspace = Workspace() 
print(workspace.get_targets())

Zie Uw toegangssleutels beheren voor meer informatie over het werken met sleutels.

Belangrijk

Als u toegangssleutels voor uw werkruimte uitschakelt, kunt u geen verbindingsreeksen gebruiken om verbinding te maken met uw werkruimte. Gebruik in plaats daarvan werkruimteparameters om verbinding te maken.

Verbinding maken met uw werkruimte met werkruimteparameters

Elke Azure Quantum-werkruimte heeft een unieke set parameters die u kunt gebruiken om verbinding te maken met de werkruimte.

Parameter Beschrijving Gebruiken wanneer u verbinding maakt met
subscription_id De Azure-abonnements-id. Azure CLI
resource_group De naam van de Azure-resourcegroep. Azure CLI
name De naam van uw Azure Quantum-werkruimte. Azure CLI
resource_id De Azure-resource-id van de Azure Quantum-werkruimte. Python

Voer de volgende stappen uit om uw werkruimteparameters te vinden:

  1. Meld u aan bij het Azure-portaal.
  2. Ga naar uw Azure Quantum-werkruimte.
  3. Kies Overzicht in het deelvenster werkruimte.
  4. Vouw de vervolgkeuzelijst Essentials uit.
  5. Kopieer de parameters in de bijbehorende velden.

Opmerking

Zorg ervoor dat u zich aanmeldt bij de juiste tenant voordat u verbinding maakt met uw werkruimte. Zie Azure-abonnementen beheren met de Azure CLI voor meer informatie over tenants.

Werkruimteparameters gebruiken om verbinding te maken met uw Azure Quantum-werkruimte

Als u aangemeld wilt blijven wanneer u uw Python-scripts uitvoert, opent u een terminal en voert u de volgende Azure CLI opdracht uit. Met deze opdracht stelt u het abonnement voor uw werkruimte in. Vervang <subscriptionId> door uw abonnements-id.

az account set --subscription <subscriptionId>

U kunt uw werkruimteparameters gebruiken om verbinding te maken met uw Azure Quantum werkruimte via de qdk.azure module of via Azure CLI.

Als u verbinding wilt maken met uw Azure Quantum werkruimte, kiest u een van de volgende opties.

  • Geef de resource-id op (aanbevolen):

    from qdk.azure import Workspace 

workspace = Workspace(resource_id="") # Add the resource ID of your workspace

  • Geef de abonnements-id, resourcegroep en werkruimtenaam op:

    from qdk.azure import Workspace 

workspace = Workspace(  
    subscription_id="", # Add the subscription ID of your workspace
    resource_group="", # Add the resource group of your workspace
    name="" # Add the name of your workspace
    )

  • Geef alleen de naam van de werkruimte op. Deze optie kan mislukken wanneer u meerdere werkruimten met dezelfde naam in dezelfde tenant hebt.

    from qdk.azure import Workspace 
workspace = Workspace(name="") # Add the name of your workspace

Gerelateerde inhoud

  • Last updated on