Hantera kvantarbetsytor med Azure CLI

I den här guiden lär du dig att använda Azure Command-Line Interface (Azure CLI) för att skapa Azure Quantum-arbetsytor och nödvändiga resursgrupper och lagringskonton och börja köra kvantprogram i Azure Quantum.

Förutsättningar

Om du vill använda Azure Quantum-tjänsten behöver du:

• 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-resursgrupp där kvantarbetsytan finns.
• Ett lagringskonto i resursgruppen som ska associeras med kvantarbetsytan. Flera arbetsytor kan associeras med samma konto.
• Azure CLI.
• Microsoft Quantum Development Kit.

Miljökonfiguration

1. Installera Azure CLI-quantum-tillägget. Öppna en kommandotolk och kör följande kommando, som även uppgraderar tillägget om en tidigare version redan är installerad:

   az extension add --upgrade -n quantum
   

2. Logga in på Azure med dina autentiseringsuppgifter. Du ser en lista över prenumerationer som är associerade med ditt konto.

   az login
   

3. Ange den prenumeration som du vill använda.

   az account set -s <Your subscription ID>
   

4. Om det är första gången du skapar kvantarbetsytor i din prenumeration registrerar du resursprovidern med det här kommandot:

   az provider register --namespace Microsoft.Quantum
   

Skapa en Azure Quantum-arbetsyta

Om du vill skapa en ny Azure Quantum-arbetsyta behöver du veta:

• Platsen eller Namnet på Azure-regionen för att skapa resursen. Du kan använda lista över regioner och deras resource manager-koder som stöds av Azure CLI-verktyget, till exempel westus.
• Resursgruppen som är associerad med den nya arbetsytan, till exempel MyResourceGroup.
• Ett lagringskonto i samma resursgrupp och prenumeration som kvantarbetsytan. Du kan skapa ett nytt lagringskonto från Az CLI-verktyget, till exempel MyStorageAccount.
• Namnet på den kvantarbetsyta som ska skapas, till exempel MyQuantumWorkspace.
• Listan över Azure Quantum-leverantörer som ska användas på arbetsytan. En leverantör erbjuder en uppsättning planer som var och en representerar en plan med tillhörande villkor, kostnader och kvoter. Om du vill skapa arbetsytor måste du ange motsvarande plan tillsammans med leverantörerna.

Om du redan känner till leverantörs- och plannamnen som ska användas på din arbetsyta kan du hoppa direkt till steg fyra nedan. Om du vill börja med de leverantörer som erbjuder kostnadsfri kredit kan du ange följande kommando:

az quantum workspace create \
   -l MyLocation \
   -g MyResourceGroup \
   -w MyQuantumWorkspace \
   -a MyStorageAccount

Du kan uppmanas att acceptera användningsvillkoren. Ange Y för att acceptera villkoren. Observera att parametern -r som visas i steg fyra, nedan, inte krävdes.

Om du behöver avgöra vilka leverantörer och planer som ska användas fortsätter du på följande sätt:

1. Om du vill hämta listan över tillgängliga kvantprovidrar använder du kommandot list (i det här exemplet används westus som plats):

   az quantum offerings list \
        -l westus \
        -o table
   

   Tips

   Om du vill se vilka leverantörer som ger kostnadsfri kredit använder du parametern --autoadd-only, till exempel:
   az quantum offerings list --autoadd-only -l westus -o table
   Som tidigare nämnts läggs dessa leverantörer automatiskt till på din arbetsyta. Du behöver inte ange dem med parametern -r.

2. När du har fastställt providern och har för avsikt att inkludera den i din arbetsyta kan du granska villkoren med hjälp av kommandot show-terms (genom att lägga till MyProviderID och MyPlan som exempelvärden):

   az quantum offerings show-terms \
        -l westus \
        -p MyProviderId \
        -k MyPlan
   

3. Utdata från kommandot show-terms innehåller ett booleskt fält accepted som visar om villkoren för den här providern redan har godkänts eller inte, samt en länk till de licensvillkor som ska granskas. Om du bestämmer dig för att godkänna dessa villkor använder du kommandot accept-terms för att registrera ditt godkännande.

   az quantum offerings accept-terms \
        -l westus \
        -p MyProviderId \
        -k MyPlan
   

4. När du har granskat och accepterat alla obligatoriska villkor kan du skapa din arbetsyta med hjälp av kommandot create och ange en lista med kombinationer av provider och abonnemang avgränsade med kommatecken, som i följande exempel:

   az quantum workspace create \
        -l westus \
        -g MyResourceGroup \
        -w MyQuantumWorkspace \
        -a MyStorageAccount \
        -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"
   

När du har skapat en arbetsyta kan du fortfarande lägga till eller ta bort leverantörer med hjälp av Azure-portalen.

Ändra standardlagringskontot för en kvantarbetsyta

Om du behöver ändra standardlagringskontot för en befintlig arbetsyta kan du använda kommandot create och ange alla aktuella egenskaper tillsammans med det nya lagringskontot. I följande exempel används samma inställningar som arbetsytan som skapades i föregående exempel:

az quantum workspace create \
   -l westus \
   -g MyResourceGroup \
   -w MyQuantumWorkspace \
   -a MyNEWStorageAccount \
   -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"

Ta bort en kvantarbetsyta

Om du känner till namnet och resursgruppen för en kvantarbetsyta som du vill ta bort kan du göra det med kommandot delete (med samma namn som i föregående exempel):

az quantum workspace delete \
   -g MyResourceGroup \
   -w MyQuantumWorkspace

När du har tagit bort en arbetsyta visas den fortfarande när den tas bort i molnet. provisioningState-egenskapen för arbetsytan ändras dock omedelbart för att visa att den tas bort. Du kan se den här informationen med hjälp av kommandot show:

az quantum workspace show \
   -g MyResourceGroup \
   -w MyQuantumWorkspace

az quantum workspace delete

Nästa steg

Nu när du kan skapa och ta bort arbetsytor kan du lära dig mer om de olika targets för att köra kvantalgoritmer i Azure Quantum.