Freigeben über

az quantum job

  • Vorschau
  • Referenz

Hinweis

Diese Referenz ist Teil der Quantenerweiterung für die Azure CLI (Version 2.41.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie zum ersten Mal einen Az-Quantenauftragsbefehl ausführen. Weitere Informationen zu Erweiterungen

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

Verwalten von Aufträgen für Azure Quantum.

Befehle

Name Beschreibung Typ Status
az quantum job cancel

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

 Erweiterung Vorschau
az quantum job list

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

 Erweiterung Vorschau
az quantum job output

Ruft die Ergebnisse der Ausführung eines Auftrags ab.

 Erweiterung Vorschau
az quantum job show

Rufen Sie den Status und details des Auftrags ab.

 Erweiterung Vorschau
az quantum job submit

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

 Erweiterung Vorschau
az quantum job wait

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

 Erweiterung Vorschau

az quantum job cancel

Vorschau

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

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

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.

--location -l

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 Quantum-Arbeitsbereichs. 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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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

Vorschau

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

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

Erforderliche Parameter

--location -l

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 Quantum-Arbeitsbereichs. 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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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

Vorschau

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

Ruft die Ergebnisse der Ausführung eines Auftrags ab.

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

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.

--location -l

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 Quantum-Arbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az quantum workspace set.

Optionale Parameter

--item

Der Elementindex in einem Batchverarbeitungsauftrag.

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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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

Vorschau

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

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.

--location -l

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 Quantum-Arbeitsbereichs. 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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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

Vorschau

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

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

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

Beispiele

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

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

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

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

Übermitteln Sie ein Q#-Programm mit Programmparametern (z. B. n-qubits = 2).

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t MyTarget --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

Übermitteln Sie QIR-Bitcode oder lesbaren LLVM-Code aus einer Datei im aktuellen Ordner.

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

Erforderliche Parameter

--location -l

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.

--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

--entry-point

Der Einstiegspunkt für das QIR-Programm oder -Schaltkreis. Erforderlich für QIR. Bei Q#-Aufträgen ignoriert.

--job-input-file

Der Speicherort der zu übermittelnden Eingabedatei. Erforderlich für QIR-, QIO- und Pass-Through-Aufträge. Bei Q#-Aufträgen ignoriert.

--job-input-format

Das Format der zu übermittelnden Datei. Lassen Sie diesen Parameter für Q#-Aufträge aus.

--job-name

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

--job-output-format

Das erwartete Auftragsausgabeformat. Bei Q#-Aufträgen ignoriert.

--job-params

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

--no-build

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

Standardwert: False
--project

[Veraltet] Der Speicherort des zu übermittelnden Q#-Projekts. Standardmäßig wird der aktuelle Ordner verwendet.

--shots

Die Anzahl der Wiederholungen des Q#-Programms für das angegebene Ziel.

--storage

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

--target-capability

Zielfunktionsparameter, der an den Compiler übergeben wird.

<PROGRAM_ARGS>

Liste der Argumente, die von dem Q#-Vorgang erwartet werden, der als --name=wert nach 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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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

Vorschau

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

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

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

Beispiele

Warten Sie auf den Abschluss eines Auftrags, überprüfen Sie in 60 Sekunden.

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.

--location -l

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 Quantum-Arbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az quantum workspace set.

Optionale Parameter

--max-poll-wait-secs

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

Standardwert: 5
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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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.