az quantum job

Hinweis

Diese Referenz ist Teil der Quantenerweiterung für die Azure CLI (Version 2.23.0 oder höher). Die Erweiterung installiert automatisch beim ersten Ausführen eines Az-Quantenauftragsbefehls . Weitere Informationen zu Erweiterungen

Verwalten von Aufträgen für Azure Quantum.

Befehle

az quantum job cancel	Fordern Sie an, einen Auftrag in Azure Quantum abzubrechen, wenn er noch nicht abgeschlossen ist.
az quantum job list	Rufen Sie die Liste der Aufträge in einem Quantum Workspace ab.
az quantum job output	Rufen Sie die Ergebnisse des Ausführens eines F#-Auftrags ab.
az quantum job show	Rufen Sie den Status und details des Auftrags ab.
az quantum job submit	Übermitteln Sie ein Q#-Projekt, das auf Azure Quantum ausgeführt werden soll.
az quantum job wait	Platzieren Sie die CLI in einem Wartezustand, bis der Auftrag ausgeführt wird.

az quantum job cancel

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

az quantum job cancel --job-id
                      [--location]
                      [--resource-group]
                      [--workspace-name]

Beispiele

Abbrechen eines Azure Quantum-Auftrags nach ID.

az quantum job cancel -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy

Erforderliche Parameter

--job-id -j

Eindeutiger Auftragsbezeichner im GUID-Format.

Optionale Parameter

--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--resource-group -g

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

--workspace-name -w

Name des Quantenarbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az quantum workspace set.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az quantum job list

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

az quantum job list [--location]
                    [--resource-group]
                    [--workspace-name]

Beispiele

Rufen Sie die Liste der Aufträge aus einem Azure Quantum-Arbeitsbereich ab.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation

Optionale Parameter

--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--resource-group -g

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

--workspace-name -w

Name des Quantenarbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az quantum workspace set.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az quantum job output

Rufen Sie die Ergebnisse des Ausführens eines F#-Auftrags ab.

az quantum job output --job-id
                      [--location]
                      [--resource-group]
                      [--workspace-name]

Beispiele

Drucken Sie die Ergebnisse eines erfolgreichen Azure Quantum-Auftrags.

az quantum job output -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy -o table

Erforderliche Parameter

--job-id -j

Eindeutiger Auftragsbezeichner im GUID-Format.

Optionale Parameter

--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--resource-group -g

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

--workspace-name -w

Name des Quantenarbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az quantum workspace set.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az quantum job show

Rufen Sie den Status und details des Auftrags ab.

az quantum job show --job-id
                    [--location]
                    [--resource-group]
                    [--workspace-name]

Beispiele

Rufen Sie den Status eines Azure Quantum-Auftrags ab.

az quantum job show -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy --query status

Erforderliche Parameter

--job-id -j

Eindeutiger Auftragsbezeichner im GUID-Format.

Optionale Parameter

--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--resource-group -g

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

--workspace-name -w

Name des Quantenarbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az quantum workspace set.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az quantum job submit

Übermitteln Sie ein Q#-Projekt, das auf Azure Quantum ausgeführt werden soll.

az quantum job submit [--job-name]
                      [--job-params]
                      [--location]
                      [--no-build]
                      [--project]
                      [--resource-group]
                      [--shots]
                      [--storage]
                      [--target-capability]
                      [--target-id]
                      [--workspace-name]
                      [<PROGRAM_ARGS>]

Beispiele

Senden Sie das Q#-Programm aus dem aktuellen Ordner.

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   --job-name MyJob

Übermitteln Sie das Q#-Programm aus dem aktuellen Ordner mit Auftragsparametern für ein Ziel.

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   --job-name MyJob --job-params param1=value1 param2=value2

Senden Sie das Q#-Programm mit Programmparametern (z. B. n-qubits = 2).

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   --job-name MyJob -- --n-qubits=2

Senden Sie ein Q#-Programm aus dem aktuellen Ordner mit einem Zielfunktionsparameter.

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --target-capability MyTargetCapability

Optionale Parameter

--job-name

Ein Anzeigename für diese Ausführung des Programms.

--job-params

Auftragsparameter, die als Liste der Schlüssel=Wertpaare an das Ziel übergeben werden.

--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--no-build

Wenn angegeben, wird das Q#-Programm nicht vor der Übermittlung erstellt.

--project

Der Speicherort des zu übermittelnden Q#-Projekts. Standardwerte für den aktuellen Ordner.

--resource-group -g

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

--shots

Die Anzahl der Male, mit denen das Q#-Programm auf dem angegebenen 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.

--target-id -t

Ausführungsmodul für Quantencomputeraufträge. Wenn ein Arbeitsbereich mit einem Anbietersatz 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 Quantenarbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az quantum workspace set.

<PROGRAM_ARGS>

Liste der Argumente, die von dem Q#-Vorgang erwartet werden, der als "-name=wert" angegeben ist --.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az quantum job wait

Platzieren Sie die CLI in einem Wartezustand, bis der Auftrag ausgeführt wird.

az quantum job wait --job-id
                    [--location]
                    [--max-poll-wait-secs]
                    [--resource-group]
                    [--workspace-name]

Beispiele

Warten Sie auf abschluss eines Auftrags, überprüfen Sie in 60 Sekunden Intervalle.

az quantum job wait -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy --max-poll-wait-secs 60 -o table

Erforderliche Parameter

--job-id -j

Eindeutiger Auftragsbezeichner im GUID-Format.

Optionale Parameter

--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--max-poll-wait-secs

Abfragezeit in Sekunden, um Azure Quantum für Ergebnisse des entsprechenden Auftrags abzufragen.

Standardwert: 5

--resource-group -g

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

--workspace-name -w

Name des Quantenarbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az quantum workspace set.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.