Ansluta till din Azure Quantum-arbetsyta med QDK eller Azure CLI

Om du har en Azure Quantum arbetsyta kan du ansluta till din arbetsyta och skicka koden med modulen qdk.azure Python. Modulen qdk.azure innehåller en Workspace klass som representerar en Azure Quantum-arbetsyta.

Förutsättningar

Om du vill ansluta till din arbetsyta med modulen qdk.azure behöver du följande:

  • Ett Azure-konto med en aktiv prenumeration. Om du inte har något Azure-konto registrerar du dig kostnadsfritt och registrerar dig för en betala per användning-prenumeration.

  • En Azure Quantum-arbetsyta. Om du inte har någon arbetsyta kan du läsa Skapa en Azure Quantum arbetsyta.

  • Den senaste versionen av qdk python-paketet med tillägget azure.

    pip install --upgrade "qdk[azure]"

Om du använder Azure CLI uppdaterar du till den senaste versionen. Installationsinstruktioner finns i:

Ansluta med en anslutningssträng

Använd en reťazec pripojenia för att ange anslutningsparametrarna till en Azure Quantum arbetsyta. Anslutningssträngar är användbara i följande scenarier:

  • Du vill dela åtkomst till din arbetsyta med andra som inte har något Azure-konto.
  • Du vill dela åtkomst till din arbetsyta med andra under en begränsad tid.
  • Du kan inte använda Microsoft Entra-ID på grund av företagsprinciper.

Tips

Varje Azure Quantum-arbetsyta har en primärnyckel och en sekundär nyckel, och varje nyckel har en egen anslutningssträng. Om du vill tillåta andra att komma åt din arbetsyta delar du den sekundära nyckeln och använder endast primärnyckeln för dina egna tjänster. Du kan ersätta den sekundära nyckeln utan att orsaka stilleståndstid i dina egna tjänster. Mer information om hur du delar åtkomst till din arbetsyta finns i Dela åtkomst till arbetsytan.

Kopiera anslutningssträngen

  1. Logga in på Azure-portalen.
  2. Gå till din Azure Quantum-arbetsyta.
  3. I arbetsytepanelen expanderar du listrutan Åtgärder och väljer Åtkomstnycklar.
  4. Aktivera åtkomstnycklar för din arbetsyta. Om skjutreglaget Åtkomstnycklar är inställt på Inaktiverat ställer du in skjutreglaget på Aktiverat.
  5. Välj ikonen Kopiera för den reťazec pripojenia som du vill kopiera. Du kan välja antingen den primära eller sekundära anslutningssträngen.

Varning

Det är en säkerhetsrisk att lagra dina kontoåtkomstnycklar eller anslutningssträngar i klartext. Lagra dina kontonycklar i ett krypterat format eller migrera dina program för att använda Microsoft Entra-auktorisering för åtkomst till din Azure Quantum-arbetsyta.

Använd anslutningssträng för att komma åt din Azure Quantum-arbetsyta

Använd anslutningssträngen du kopierade för att ansluta till din Azure Quantum-arbetsyta med modulen qdk.azure eller QDK-tillägget i Visual Studio Code.

Om du vill ansluta till din Azure Quantum arbetsyta väljer du någon av följande metoder.

  • from_connection_string Använd funktionen för att skapa ett Workspace objekt.

    from qdk.azure import Workspace 

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

print(workspace.get_targets())

  • Lagra din reťazec pripojenia i en miljövariabel.

    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())

Mer information om hur du arbetar med nycklar finns i Hantera dina åtkomstnycklar.

Viktigt!

Om du inaktiverar åtkomstnycklar för din arbetsyta kan du inte använda anslutningssträngar för att ansluta till din arbetsyta. Använd arbetsyteparametrar för att ansluta i stället.

Ansluta till din arbetsyta med arbetsyteparametrar

Varje Azure Quantum-arbetsyta har en unik uppsättning parametrar som du kan använda för att ansluta till arbetsytan.

Parameter Beskrivning Använd när du ansluter till
subscription_id Prenumerations-ID för Azure. Azure CLI
resource_group Namnet på Azure-resursgruppen. Azure CLI
name Namnet på din Azure Quantum-arbetsyta. Azure CLI
resource_id Azure-resurs-ID för Azure Quantum-arbetsytan. Python

Följ dessa steg för att hitta dina arbetsyteparametrar:

  1. Logga in på Azure-portalen.
  2. Gå till din Azure Quantum-arbetsyta.
  3. Välj Översikt på arbetsytans panel.
  4. Öppna listrutan Essentials.
  5. Kopiera parametrarna i motsvarande fält.

Anmärkning

Kontrollera att du loggar in på rätt klientorganisation innan du ansluter till din arbetsyta. Mer information om klienter finns i Hantera Azure-prenumerationer med Azure CLI.

Använda arbetsyteparametrar för att ansluta till din Azure Quantum-arbetsyta

Om du vill förbli inloggad när du kör dina Python-skript öppnar du en terminal och kör följande Azure CLI kommando. Det här kommandot anger prenumerationen för din arbetsyta. Ersätt <subscriptionId> med ditt prenumerations-ID.

az account set --subscription <subscriptionId>

Du kan använda dina arbetsyteparametrar för att ansluta till din Azure Quantum arbetsyta via modulen qdk.azure eller via Azure CLI.

Om du vill ansluta till din Azure Quantum arbetsyta väljer du något av följande alternativ.

  • Ange resurs-ID (rekommenderas):

    from qdk.azure import Workspace 

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

  • Ange prenumerations-ID, resursgrupp och arbetsytenamn:

    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
    )

  • Ange endast arbetsytans namn. Det här alternativet kan misslyckas när du har flera arbetsytor som har samma namn i samma klientorganisation.

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

Relaterat innehåll

  • Last updated on