az quantum job

Vorschau

Note

Diese Referenz ist Teil der Quantenerweiterung für die Azure CLI (Version 2.73.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie zum ersten Mal einen Az-Quantenauftragsbefehl ausführen. Erfahren Sie mehr über 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.	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 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

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.

--workspace-name -w

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

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

Ausgabeformat.

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 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
                    [--created-after]
                    [--created-before]
                    [--item-type]
                    [--job-name]
                    [--job-type]
                    [--order]
                    [--orderby]
                    [--provider-id]
                    [--skip]
                    [--status]
                    [--target-id]
                    [--top]

Beispiele

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

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

Auflisten von Aufträgen, die den Quantinuumanbieter verwendet haben.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --provider-id quantinuum

Listet Aufträge auf, die für das ionq.simulator-Ziel ausgeführt wurden.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --target-id ionq.simulator

Aufträge auflisten, die erfolgreich abgeschlossen wurden.

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

Nach dem 15. Januar 2025 erstellte Aufträge auflisten.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --created-after 2025-01-15

Auflisten von Aufträgen, deren Namen mit "Generieren..." beginnen.

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

Überspringen Sie die ersten 50 Aufträge, beginnen Sie mit dem Eintrag bei der 51. Stelle und listen Sie 10 Aufträge auf.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --skip 50 --top 10

Sortieren Sie die Auftragsliste nach Ziel-ID, und zeigen Sie sie im tabellarischen Format an.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --orderby Target -o table

Sortieren Sie die Auftragsliste nach Auftragsname in absteigender Reihenfolge, die im tabellarischen Format angezeigt wird.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --orderby Name --order desc -o table

Erforderliche Parameter

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

--workspace-name -w

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--created-after

Aufträge, die nach diesem Datum erstellt wurden, werden aufgelistet.

--created-before

Aufträge, die vor diesem Datum erstellt wurden, werden aufgelistet.

--item-type

Elementtyp, der aufgelistet werden soll, "Auftrag" oder "Sitzung".

--job-name

Auftragsname, der aufgelistet werden soll (Suche nach Präfix), Beispiel "Mein Auftrag".

--job-type

Auftragstyp, der aufgelistet werden soll, Beispiel "QuantumComputing".

--order

So ordnen Sie die Liste an: asc oder desc.

--orderby

Das Feld, in dem die Liste sortiert werden soll.

--provider-id -p

Bezeichner eines Azure Quantum-Anbieters.

--skip

Anzahl von Aufträgen, die beim Zurückgeben einer Auftragsliste übersprungen werden sollen.

--status

Der Status von Aufträgen, die aufgelistet werden sollen.

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

--top

Die Anzahl der pro Seite aufgeführten Aufträge.

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

Ausgabeformat.

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

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

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.

--workspace-name -w

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

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

Ausgabeformat.

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

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.

--workspace-name -w

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

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

Ausgabeformat.

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

Übermitteln Sie QIR-Bitcode 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

Übermitteln Sie einen Quil Pass-Through-Auftrag an den Rigetti-Simulator.

az quantum job submit -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 IonQ JSON-Schaltkreis mit Auftragsparametern an den IonQ-Simulator.

az quantum job submit -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

--workspace-name -w

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--entry-point

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

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

Ausgabeformat.

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

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.

--workspace-name -w

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--max-poll-wait-secs

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

Eigenschaft	Wert
Standardwert:	5

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

Ausgabeformat.

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

Feedback

War diese Seite hilfreich?

Freigeben über

az quantum job

Befehle

az quantum job cancel

Beispiele

Erforderliche Parameter

az quantum job list

Beispiele

Erforderliche Parameter

Optionale Parameter

az quantum job output

Beispiele

Erforderliche Parameter

az quantum job show

Beispiele

Erforderliche Parameter

az quantum job submit

Beispiele

Erforderliche Parameter

Optionale Parameter

az quantum job wait

Beispiele

Erforderliche Parameter

Optionale Parameter

Feedback