Freigeben über

az quantum

  • Vorschau

Note

This reference is part of the quantum extension for the Azure CLI (version 2.41.0 or higher). The extension will automatically install the first time you run an az quantum command. Learn more about extensions.

Diese Befehlsgruppe befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Verwalten Sie Azure Quantum Workspaces, und übermitteln Sie Aufträge an Azure Quantum Providers.

Befehle

Name Beschreibung Typ Status
az quantum execute

Übermitteln Sie einen Auftrag, der auf Azure Quantum ausgeführt werden soll, und warten Sie auf das Ergebnis. Entspricht az quantum run.

 Extension Preview
az quantum job

Verwalten von Aufträgen für Azure Quantum.

 Extension Preview
az quantum job cancel

Fordern Sie an, einen Auftrag in Azure Quantum abzubrechen, wenn er nicht abgeschlossen wurde.

 Extension Preview
az quantum job list

Rufen Sie die Liste der Aufträge in einem Quantum Workspace ab.

 Extension Preview
az quantum job output

Ruft die Ergebnisse der Ausführung eines Auftrags ab.

 Extension Preview
az quantum job show

Rufen Sie den Status und details des Auftrags ab.

 Extension Preview
az quantum job submit

Übermitteln Sie ein Programm oder eine Leitung, die auf Azure Quantum ausgeführt werden soll.

 Extension Preview
az quantum job wait

Platzieren Sie die CLI in einem Wartezustand, bis der Auftrag abgeschlossen ist.

 Extension Preview
az quantum offerings

Verwalten Sie Anbieterangebote für Azure Quantum.

 Extension Preview
az quantum offerings accept-terms

Akzeptieren Sie die Bedingungen einer Anbieter- und SKU-Kombination, um sie für die Erstellung von Arbeitsbereichen zu aktivieren.

 Extension Preview
az quantum offerings list

Rufen Sie die Liste aller Anbieterangebote ab, die am angegebenen Standort verfügbar sind.

 Extension Preview
az quantum offerings show-terms

Zeigen Sie die Bedingungen eines Anbieters und einer SKU-Kombination einschließlich Lizenz-URL und Akzeptanzstatus an.

 Extension Preview
az quantum run

Übermitteln Sie einen Auftrag, der auf Azure Quantum ausgeführt werden soll, und warten Sie auf das Ergebnis. Entspricht az quantum execute.

 Extension Preview
az quantum target

Verwalten Sie Ziele für Azure Quantum-Arbeitsbereiche.

 Extension Preview
az quantum target clear

Löschen Sie die Standardziel-ID.

 Extension Preview
az quantum target list

Rufen Sie die Liste der Anbieter und deren Ziele in einem Azure Quantum-Arbeitsbereich ab.

 Extension Preview
az quantum target set

Wählen Sie das Standardziel aus, das beim Übermitteln von Aufträgen an Azure Quantum verwendet werden soll.

 Extension Preview
az quantum target show

Rufen Sie die Ziel-ID des aktuellen Standardziels ab, das beim Übermitteln von Aufträgen an Azure Quantum verwendet werden soll.

 Extension Preview
az quantum workspace

Verwalten von Azure Quantum-Arbeitsbereichen.

 Extension Preview
az quantum workspace clear

Löschen Sie den standardmäßigen Azure Quantum-Arbeitsbereich.

 Extension Preview
az quantum workspace create

Erstellen Sie einen neuen Azure Quantum-Arbeitsbereich.

 Extension Preview
az quantum workspace delete

Löschen Sie den angegebenen (oder aktuellen) Azure Quantum-Arbeitsbereich.

 Extension Preview
az quantum workspace keys

Verwalten von Azure Quantum Workspace-API-Schlüsseln.

 Extension Preview
az quantum workspace keys list

Auflisten von API-Schlüsseln für den angegebenen (oder aktuellen) Azure Quantum-Arbeitsbereich.

 Extension Preview
az quantum workspace keys regenerate

Generieren Sie den API-Schlüssel für den angegebenen (oder aktuellen) Azure Quantum-Arbeitsbereich neu.

 Extension Preview
az quantum workspace list

Rufen Sie die Liste der verfügbaren Azure Quantum-Arbeitsbereiche ab.

 Extension Preview
az quantum workspace quotas

Listen Sie die Kontingente für den angegebenen (oder aktuellen) Azure Quantum-Arbeitsbereich auf.

 Extension Preview
az quantum workspace set

Wählen Sie einen Standardmäßigen Azure Quantum-Arbeitsbereich für zukünftige Befehle aus.

 Extension Preview
az quantum workspace show

Rufen Sie die Details des angegebenen (oder aktuellen) Azure Quantum-Arbeitsbereichs ab.

 Extension Preview
az quantum workspace update

Aktualisieren Sie den angegebenen (oder aktuellen) Azure Quantum-Arbeitsbereich.

 Extension Preview

az quantum execute

Vorschau

Die Befehlsgruppe "Quantum" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Übermitteln Sie einen Auftrag, der auf Azure Quantum ausgeführt werden soll, und warten Sie auf das Ergebnis. Entspricht az quantum run.

az quantum execute --job-input-file
                   --job-input-format
                   --location
                   --resource-group
                   --target-id
                   --workspace-name
                   [--entry-point]
                   [--job-name]
                   [--job-output-format]
                   [--job-params]
                   [--shots]
                   [--storage]
                   [--target-capability]

Beispiele

Führen Sie QIR-Bitcode aus einer Datei im aktuellen Ordner aus, und warten Sie auf das Ergebnis.

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-name MyJob --job-input-format qir.v1 --job-input-file MyQirBitcode.bc \
    --entry-point MyQirEntryPoint

Führen Sie einen Quil Pass-Through-Auftrag auf dem Rigetti-Simulator aus, und warten Sie auf das Ergebnis.

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t rigetti.sim.qvm --job-name MyJob --job-input-file MyProgram.quil \
   --job-input-format rigetti.quil.v1 --job-output-format rigetti.quil-results.v1

Übermitteln Sie einen Qiskit-Schaltkreis mit Auftragsparametern an den IonQ-Simulator, und warten Sie auf die Ergebnisse.

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t ionq.simulator --job-name MyJobName --job-input-file MyCircuit.json \
   --job-input-format ionq.circuit.v1 --job-output-format ionq.quantum-results.v1 \
   --job-params count=100 content-type=application/json

Erforderliche Parameter

--job-input-file

Der Speicherort der zu übermittelnden Eingabedatei.

--job-input-format

Das Format der zu übermittelnden Datei.

--location -l

Location. Werte aus: az account list-locations. Sie können den Standardspeicherort mithilfe von az configure --defaults location=<location>konfigurieren.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--target-id -t

Ausführungsmodul für Quantencomputingaufträge. Wenn ein Arbeitsbereich mit einer Reihe von Anbietern konfiguriert ist, aktivieren sie jeweils ein oder mehrere Ziele. Sie können das Standardziel mithilfe von az quantum target set.

--workspace-name -w

Name des Quantum-Arbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az quantum workspace set.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--entry-point

Der Einstiegspunkt für das QIR-Programm oder -Schaltkreis. Erforderlich für QIR-Aufträge.

--job-name

Ein Anzeigename, der dieser Ausführung des Programms zugewiesen werden soll.

--job-output-format

Das erwartete Auftragsausgabeformat.

--job-params

Auftragsparameter, die als Liste von Key=Wert-Paaren, JSON-Zeichenfolgen oder @{file} json-Inhalten an das Ziel übergeben werden.

--shots

Die Anzahl der Male, mit denen das Programm für das angegebene Ziel ausgeführt werden soll.

--storage

Wenn angegeben, wird die ConnectionString eines Azure Storage verwendet, um Auftragsdaten und Ergebnisse zu speichern.

--target-capability

Zielfunktionsparameter, der an den Compiler übergeben wird.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az quantum run

Vorschau

Die Befehlsgruppe "Quantum" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Übermitteln Sie einen Auftrag, der auf Azure Quantum ausgeführt werden soll, und warten Sie auf das Ergebnis. Entspricht az quantum execute.

az quantum run --job-input-file
               --job-input-format
               --location
               --resource-group
               --target-id
               --workspace-name
               [--entry-point]
               [--job-name]
               [--job-output-format]
               [--job-params]
               [--shots]
               [--storage]
               [--target-capability]

Beispiele

Führen Sie QIR-Bitcode aus einer Datei im aktuellen Ordner aus, und warten Sie auf das Ergebnis.

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-name MyJob --job-input-format qir.v1 --job-input-file MyQirBitcode.bc \
    --entry-point MyQirEntryPoint

Führen Sie einen Quil Pass-Through-Auftrag auf dem Rigetti-Simulator aus, und warten Sie auf das Ergebnis.

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t rigetti.sim.qvm --job-name MyJob --job-input-file MyProgram.quil \
   --job-input-format rigetti.quil.v1 --job-output-format rigetti.quil-results.v1

Übermitteln Sie einen Qiskit-Schaltkreis mit Auftragsparametern an den IonQ-Simulator, und warten Sie auf die Ergebnisse.

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t ionq.simulator --job-name MyJobName --job-input-file MyCircuit.json \
   --job-input-format ionq.circuit.v1 --job-output-format ionq.quantum-results.v1 \
   --job-params count=100 content-type=application/json

Erforderliche Parameter

--job-input-file

Der Speicherort der zu übermittelnden Eingabedatei.

--job-input-format

Das Format der zu übermittelnden Datei.

--location -l

Location. Werte aus: az account list-locations. Sie können den Standardspeicherort mithilfe von az configure --defaults location=<location>konfigurieren.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--target-id -t

Ausführungsmodul für Quantencomputingaufträge. Wenn ein Arbeitsbereich mit einer Reihe von Anbietern konfiguriert ist, aktivieren sie jeweils ein oder mehrere Ziele. Sie können das Standardziel mithilfe von az quantum target set.

--workspace-name -w

Name des Quantum-Arbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az quantum workspace set.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--entry-point

Der Einstiegspunkt für das QIR-Programm oder -Schaltkreis. Erforderlich für QIR-Aufträge.

--job-name

Ein Anzeigename, der dieser Ausführung des Programms zugewiesen werden soll.

--job-output-format

Das erwartete Auftragsausgabeformat.

--job-params

Auftragsparameter, die als Liste von Key=Wert-Paaren, JSON-Zeichenfolgen oder @{file} json-Inhalten an das Ziel übergeben werden.

--shots

Die Anzahl der Male, mit denen das Programm für das angegebene Ziel ausgeführt werden soll.

--storage

Wenn angegeben, wird die ConnectionString eines Azure Storage verwendet, um Auftragsdaten und Ergebnisse zu speichern.

--target-capability

Zielfunktionsparameter, der an den Compiler übergeben wird.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False