Kwantumwerkruimten beheren met de Azure CLI

Artikel
10/26/2023

In deze handleiding leert u hoe u de Azure Command-Line Interface (Azure CLI) gebruikt om Azure Quantum-werkruimten en de vereiste resourcegroepen en opslagaccounts te maken en uw kwantumtoepassingen in Azure Quantum uit te voeren.

Vereisten

Als u de Azure Quantum-service wilt gebruiken, hebt u het volgende nodig:

Een Azure-account met een actief abonnement. Als u geen Azure-account hebt, registreert u zich gratis en meldt u zich aan voor een abonnement op basis van betalen per gebruik.
Een Azure-resourcegroep waarin de kwantumwerkruimte zich bevindt.
Een opslagaccount in de resourcegroep dat moet worden gekoppeld aan de kwantumwerkruimte. Meerdere werkruimten kunnen aan hetzelfde account worden gekoppeld.
De Azure CLI.
De Microsoft Quantum Development Kit.

Configuratie van de omgeving

Installeer de Azure CLI-extensie quantum . Open een opdrachtprompt en voer de volgende opdracht uit, waarmee ook de extensie wordt bijgewerkt als er al een eerdere versie is geïnstalleerd:
```
az extension add --upgrade -n quantum
```
Meld u aan bij Azure met uw referenties. U ziet een lijst met abonnementen die zijn gekoppeld aan uw account.
```
az login
```
Geef het abonnement op dat u wilt gebruiken.
```
az account set -s <Your subscription ID>
```
Als dit de eerste keer is dat u kwantumwerkruimten in uw abonnement maakt, registreert u de resourceprovider met deze opdracht:
```
az provider register --namespace Microsoft.Quantum
```

Een Azure Quantum-werkruimte maken

Als u een nieuwe Azure Quantum-werkruimte wilt maken, moet u het volgende weten:

De locatie of de naam van de Azure-regio waar de resource zich bevindt. U kunt de lijst met regio's en de bijbehorende resourcebeheercodes gebruiken die worden ondersteund door het Azure CLI-hulpprogramma, bijvoorbeeld westus.
De resourcegroep die is gekoppeld aan de nieuwe werkruimte, bijvoorbeeld MyResourceGroup.
Een opslagaccount in dezelfde resourcegroep en hetzelfde abonnement als de kwantumwerkruimte. Het is mogelijk om een nieuw opslagaccount te maken vanuit het Az CLI-hulpprogramma, bijvoorbeeld MyStorageAccount.
De naam van de kwantumwerkruimte die moet worden gemaakt, bijvoorbeeld MyQuantumWorkspace.
De lijst met Azure Quantum-providers die moeten worden gebruikt in de werkruimte. Een provider biedt een set abonnementen, die elk een plan vertegenwoordigen met bijbehorende voorwaarden, kosten en quota. Als u werkruimten wilt maken, moet u het bijbehorende abonnement samen met de providers opgeven, tenzij u wilt beginnen met de providers die gratis tegoed aanbieden. Deze worden automatisch toegevoegd aan uw werkruimte.

Als u al weet welke provider- en plannamen u in uw werkruimte moet gebruiken, kunt u doorgaan naar stap vier hieronder. Als u wilt beginnen met de providers die gratis tegoed aanbieden, kunt u de volgende opdracht invoeren:

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

Mogelijk wordt u gevraagd om de gebruiksvoorwaarden te accepteren. Voer in Y om de voorwaarden te accepteren. Houd er rekening mee dat de -r parameter die in stap vier hieronder wordt weergegeven, niet vereist is.

Als u wilt bepalen welke providers en abonnementen u wilt gebruiken, gaat u als volgt te werk:

Als u de lijst met beschikbare kwantumproviders wilt ophalen, gebruikt u de list opdracht (in dit voorbeeld wordt westus als locatie gebruikt):
```
az quantum offerings list \
     -l westus \
     -o table
```
Tip

Als u wilt zien welke providers gratis tegoed geven, gebruikt u de --autoadd-only parameter, bijvoorbeeld:
az quantum offerings list --autoadd-only -l westus -o table
Zoals eerder vermeld, worden deze providers automatisch toegevoegd aan uw werkruimte. U hoeft ze niet op te geven met de -r parameter .
Zodra u de provider hebt bepaald en van plan bent om op te nemen in uw werkruimte, kunt u de voorwaarden bekijken met behulp van de show-terms opdracht (voeg uw MyProviderID en MyPlan als voorbeeldwaarden toe):
```
az quantum offerings show-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
De uitvoer van de show-terms opdracht bevat een Booleaans veld accepted dat laat zien of de voorwaarden voor deze provider al zijn geaccepteerd of niet, evenals een koppeling naar de licentievoorwaarden die moeten worden gecontroleerd. Als u besluit deze voorwaarden te accepteren, gebruikt u de accept-terms opdracht om uw acceptatie vast te leggen.
```
az quantum offerings accept-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
Zodra u alle vereiste voorwaarden hebt bekeken en geaccepteerd, kunt u uw werkruimte maken met behulp van de create opdracht, waarbij u een lijst met combinaties van providers en plannen opgeeft, gescheiden door komma's, zoals in het volgende voorbeeld:
```
az quantum workspace create \
     -l westus \
     -g MyResourceGroup \
     -w MyQuantumWorkspace \
     -a MyStorageAccount \
     -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"
```

Nadat u een werkruimte hebt gemaakt, kunt u nog steeds providers toevoegen of verwijderen met behulp van de Azure Portal.

Het standaardopslagaccount voor een kwantumwerkruimte wijzigen

Als u het standaardopslagaccount voor een bestaande werkruimte wilt wijzigen, kunt u de create opdracht gebruiken om alle huidige eigenschappen en het nieuwe opslagaccount op te geven. In het volgende voorbeeld worden dezelfde instellingen gebruikt als de werkruimte die in het vorige voorbeeld is gemaakt:

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

Belangrijk

Met deze procedure wordt de werkruimte opnieuw gemaakt met het nieuwe opslagaccount. Zorg ervoor dat alle eigenschappen behalve het opslagaccount exact hetzelfde zijn als de oorspronkelijke, anders wordt er een tweede werkruimte gemaakt.

Een kwantumwerkruimte verwijderen

Als u de naam en resourcegroep weet van een kwantumwerkruimte die u wilt verwijderen, kunt u dit doen met de delete opdracht (met dezelfde namen als in het vorige voorbeeld):

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

Tip

Als u de exacte naam niet meer weet, kunt u de volledige lijst met kwantumwerkruimten in uw abonnement bekijken met behulp van az quantum workspace list -o table.

Nadat u een werkruimte hebt verwijderd, wordt deze nog steeds weergegeven terwijl deze in de cloud wordt verwijderd. De eigenschap van de werkruimte wordt echter provisioningState onmiddellijk gewijzigd om aan te geven dat deze wordt verwijderd. U kunt deze informatie bekijken met behulp van de show opdracht:

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

Notitie

Als u de az quantum workspace set opdracht eerder hebt gebruikt om een standaard kwantumwerkruimte op te geven, kunt u de delete opdracht aanroepen zonder parameters om de standaardwerkruimte te verwijderen (en te wissen).

az quantum workspace delete

Volgende stappen

Nu u werkruimten kunt maken en verwijderen, leert u meer over de verschillende targets om kwantumalgoritmen in Azure Quantum uit te voeren.