Verwalten von Quantenarbeitsbereichen mit der Azure CLI

Artikel
10/28/2023

In diesem Leitfaden erfahren Sie, wie Sie mithilfe der Azure-Befehlszeilenschnittstelle (Azure Command-Line Interface, Azure CLI) Azure Quantum-Arbeitsbereiche und die erforderlichen Ressourcengruppen und Speicherkonten erstellen und mit der Ausführung Ihrer Quantenanwendungen in Azure Quantum beginnen.

Voraussetzungen

Für die Verwendung des Azure Quantum-Diensts benötigen Sie Folgendes:

Ein Azure-Konto mit einem aktiven Abonnement. Wenn Sie über kein Azure-Konto verfügen, registrieren Sie sich kostenlos, und registrieren Sie sich für ein Abonnement mit nutzungsbasierter Bezahlung.
Eine Azure-Ressourcengruppe, in der sich der Quantenarbeitsbereich befindet.
Ein Speicherkonto in der Ressourcengruppe, das dem Quantenarbeitsbereich zugeordnet werden soll. Mehrere Arbeitsbereiche können demselben Konto zugeordnet werden.
Die Azure CLI
Microsoft Quantum Development Kit.

Einrichten der Umgebung

Installieren Sie die Azure CLI-Erweiterung quantum. Öffnen Sie eine Eingabeaufforderung, und führen Sie den folgenden Befehl aus, der auch die Erweiterung aktualisiert, wenn bereits eine frühere Version installiert ist:
```
az extension add --upgrade -n quantum
```
Melden Sie sich mit Ihren Anmeldeinformationen bei Azure an. Sie sehen eine Liste der Abonnements, die Ihrem Konto zugeordnet sind.
```
az login
```

Geben Sie das gewünschte Abonnement an.

az account set -s <Your subscription ID>

Registrieren Sie den Ressourcenanbieter mit diesem Befehl, falls Sie zum ersten Mal Quantenarbeitsbereiche in Ihrem Abonnement erstellen:
```
az provider register --namespace Microsoft.Quantum
```

Erstellen eines Azure Quantum-Arbeitsbereichs

Um einen neuen Azure Quantum-Arbeitsbereich zu erstellen, müssen Sie Folgendes wissen:

Den Namen des Standorts oder der Azure-Region, in der die Ressource gespeichert wird. Sie können die Liste mit den vom Azure CLI-Tool unterstützten Regionen und deren Resource Manager-Codes verwenden, z. B. westus.
Die Ressourcengruppe, die dem neuen Arbeitsbereich zugeordnet ist, z. B. MyResourceGroup.
Ein Speicherkonto in derselben Ressourcengruppe und demselben Abonnement des Quantenarbeitsbereichs. Es ist möglich, mit dem Azure CLI-Tool ein neues Speicherkonto zu erstellen, z. B. MyStorageAccount.
Den Namen des zu erstellenden Quantenarbeitsbereichs, z. B. MyQuantumWorkspace.
Die Liste der Azure Quantum-Anbieter, die im Arbeitsbereich verwendet werden. Ein Anbieter stellt eine Reihe von Plänen bereit, die jeweils einen Plan mit zugehörigen Geschäftsbedingungen, Kosten und Kontingenten darstellen. Um Arbeitsbereiche zu erstellen, müssen Sie den entsprechenden Plan zusammen mit den Anbietern angeben, es sei denn, Sie möchten mit den Anbietern beginnen, die ein kostenloses Guthaben anbieten – diese werden Ihrem Arbeitsbereich automatisch hinzugefügt.

Wenn Sie bereits die Namen für den Anbieter und Plan kennen, die in Ihrem Arbeitsbereich verwendet werden sollen, können Sie direkt mit Schritt 4 weiter unten fortfahren. Wenn Sie mit den Anbietern beginnen möchten, die kostenloses Guthaben anbieten, können Sie den folgenden Befehl eingeben:

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

Möglicherweise werden Sie aufgefordert, die Nutzungsbedingungen zu akzeptieren. Geben Sie Y ein, um die Bedingungen zu akzeptieren: Beachten Sie, dass der in Schritt vier gezeigte Parameter -r nicht erforderlich war.

Wenn Sie ermitteln müssen, welche Anbieter und Pläne verwendet werden sollen, fahren Sie wie folgt fort:

Verwenden Sie den Befehl list (in diesem Beispiel wird westus als Standort verwendet), um die Liste mit den verfügbaren Quantenanbietern abzurufen:
```
az quantum offerings list \
     -l westus \
     -o table
```
Tipp

Wenn Sie sehen möchten, welche Anbieter kostenloses Guthaben bereitstellen, können Sie beispielsweise den Parameter --autoadd-only verwenden:
az quantum offerings list --autoadd-only -l westus -o table
Wie bereits erwähnt, werden diese Anbieter automatisch Ihrem Arbeitsbereich hinzugefügt. Sie müssen sie nicht mit dem Parameter -r angeben.
Nachdem Sie den Anbieter und den Plan für die Einbindung in Ihren Arbeitsbereich ermittelt haben, können Sie die Bedingungen mit dem Befehl show-terms anzeigen (mit Ihren Werten für MyProviderID und MyPlan als Beispielwerten):
```
az quantum offerings show-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
Die Ausgabe des Befehls show-terms enthält das boolesche Feld accepted, in dem angezeigt wird, ob die Bedingungen für diesen Anbieter bereits akzeptiert wurden. Darüber hinaus enthält sie einen Link zu den zu prüfenden Lizenzbedingungen. Verwenden Sie den Befehl accept-terms, um die Bedingungen zu akzeptieren, wenn Sie ihnen zustimmen.
```
az quantum offerings accept-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
Nachdem Sie alle erforderlichen Geschäftsbedingungen überprüft und akzeptiert haben, können Sie Ihren Arbeitsbereich mit dem Befehl create erstellen und dabei eine Liste mit Kombinationen aus Anbieter und Plan angeben (durch Kommas getrennt). Dies ist im folgenden Beispiel dargestellt:
```
az quantum workspace create \
     -l westus \
     -g MyResourceGroup \
     -w MyQuantumWorkspace \
     -a MyStorageAccount \
     -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"
```

Nachdem Sie einen Arbeitsbereich erstellt haben, können Sie weiterhin Anbieter mithilfe des Azure-Portal hinzufügen oder entfernen.

Ändern des Standardspeicherkontos für einen Quantenarbeitsbereich

Wenn Sie das Standardspeicherkonto für einen bereits vorhandenen Arbeitsbereich ändern möchten, können Sie den Befehl create verwenden und dabei alle aktuellen Eigenschaften sowie das neue Speicherkonto angeben. Im folgenden Beispiel werden die gleichen Einstellungen verwendet wie bei dem Arbeitsbereich, der im vorherigen Beispiel erstellt wurde:

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

Wichtig

Bei diesem Verfahren wird der Arbeitsbereich mit dem neuen Speicherkonto neu erstellt. Stellen Sie sicher, dass alle anderen Eigenschaften als das Speicherkonto genau mit dem ursprünglichen identisch sind, andernfalls wird ein zweiter Arbeitsbereich erstellt.

Löschen eines Quantenarbeitsbereichs

Wenn Sie den Namen und die Ressourcengruppe eines Quantenarbeitsbereichs kennen, den Sie löschen möchten, können Sie den Befehl delete verwenden (mit den gleichen Namen wie im vorherigen Beispiel):

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

Tipp

Wenn Sie sich nicht mehr genau an den Namen erinnern, können Sie die gesamte Liste der Quantenarbeitsbereiche mit az quantum workspace list -o table in Ihrem Abonnement anzeigen.

Nachdem Sie einen Arbeitsbereich gelöscht haben, wird er weiterhin aufgeführt, während er in der Cloud gelöscht wird. Die Eigenschaft provisioningState des Arbeitsbereichs ändert sich aber sofort, um das Löschen anzuzeigen. Sie können diese Informationen mit dem Befehl show anzeigen:

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

Hinweis

Falls Sie den Befehl az quantum workspace set bereits verwendet haben, um einen standardmäßigen Quantenarbeitsbereich anzugeben, können Sie den Befehl delete ohne Parameter aufrufen, um den Standardarbeitsbereich zu löschen.

az quantum workspace delete

Nächste Schritte

Nachdem Sie nun Arbeitsbereiche erstellen und löschen können, erfahren Sie mehr über die verschiedenen targets Möglichkeiten zum Ausführen von Quantenalgorithmen in Azure Quantum.