Udostępnij za pośrednictwem

az quantum job

  • Wersja zapoznawcza
  • Odwołanie

Uwaga

Ta dokumentacja jest częścią rozszerzenia kwantowego interfejsu wiersza polecenia platformy Azure (wersja 2.41.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az quantum job . Dowiedz się więcej o rozszerzeniach.

Grupa poleceń "quantum" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Zarządzanie zadaniami dla usługi Azure Quantum.

Polecenia

Nazwa Opis Typ Stan
az quantum job cancel

Żądanie anulowania zadania w usłudze Azure Quantum, jeśli nie zostało ukończone.

 Rozszerzenie Prapremiera
az quantum job list

Pobierz listę zadań w obszarze roboczym kwantowym.

 Rozszerzenie Prapremiera
az quantum job output

Pobierz wyniki uruchamiania zadania.

 Rozszerzenie Prapremiera
az quantum job show

Uzyskaj stan i szczegóły zadania.

 Rozszerzenie Prapremiera
az quantum job submit

Prześlij program lub obwód do uruchomienia w usłudze Azure Quantum.

 Rozszerzenie Prapremiera
az quantum job wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu zakończenia działania zadania.

 Rozszerzenie Prapremiera

az quantum job cancel

Wersja zapoznawcza

Grupa poleceń "quantum" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Żądanie anulowania zadania w usłudze Azure Quantum, jeśli nie zostało ukończone.

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

Przykłady

Anuluj zadanie usługi Azure Quantum według identyfikatora.

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

Parametry wymagane

--job-id -j

Unikatowy identyfikator zadania w formacie GUID.

--location -l

Lokalizacja. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--workspace-name -w

Nazwa obszaru roboczego quantum. Domyślny obszar roboczy można skonfigurować przy użyciu polecenia az quantum workspace set.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az quantum job list

Wersja zapoznawcza

Grupa poleceń "quantum" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Pobierz listę zadań w obszarze roboczym kwantowym.

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]

Przykłady

Pobierz listę zadań z obszaru roboczego usługi Azure Quantum.

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

Wyświetlanie listy zadań, które używały dostawcy microsoft-elements.

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

Wyświetl listę zadań uruchomionych w obiekcie docelowym microsoft.dft.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --target-id microsoft.dft

Wyświetl listę zadań zakończonych pomyślnie.

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

Wyświetl listę zadań utworzonych po 15 stycznia 2025 r.

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

Wyświetl listę zadań, których nazwy zaczynają się od "Generuj...".

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

Pomiń pierwsze 50 zadań, zacznij wyświetlać listę 51 zadań i wyświetlić listę 10 zadań.

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

Posortuj listę zadań według identyfikatora docelowego i wyświetl w formacie tabelarycznym.

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

Posortuj listę zadań według nazwy zadania w kolejności malejącej, wyświetlając je w formacie tabelarycznym.

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

Parametry wymagane

--location -l

Lokalizacja. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--workspace-name -w

Nazwa obszaru roboczego quantum. Domyślny obszar roboczy można skonfigurować przy użyciu polecenia az quantum workspace set.

Parametry opcjonalne

--created-after

Zadania utworzone po tej dacie, które mają zostać wyświetlone.

--created-before

Zadania utworzone przed tą datą, które mają zostać wyświetlone.

--item-type

Typ elementu, który ma być wyświetlany, "zadanie" lub "sesja".

--job-name

Przyjazna nazwa do nadania temu uruchomieniu programu.

--job-type

Typ zadania do na liście, na przykład "QuantumComputing".

--order

Jak uporządkować listę: asc lub desc.

--orderby

Pole, na którym ma być uporządkowana lista.

--provider-id -p

Identyfikator dostawcy usługi Azure Quantum.

--skip

Ile zadań należy pominąć podczas zwracania listy zadań.

--status

Stan zadań do wyświetlania.

--target-id -t

Aparat wykonywania dla zadań obliczeń kwantowych. Po skonfigurowaniu obszaru roboczego z zestawem dostawców każda z nich włącza co najmniej jeden element docelowy. Domyślny element docelowy można skonfigurować przy użyciu polecenia az quantum target set.

--top

Liczba zadań wymienionych na stronie.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az quantum job output

Wersja zapoznawcza

Grupa poleceń "quantum" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Pobierz wyniki uruchamiania zadania.

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

Przykłady

Wydrukuj wyniki pomyślnego zadania usługi Azure Quantum.

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

Parametry wymagane

--job-id -j

Unikatowy identyfikator zadania w formacie GUID.

--location -l

Lokalizacja. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--workspace-name -w

Nazwa obszaru roboczego quantum. Domyślny obszar roboczy można skonfigurować przy użyciu polecenia az quantum workspace set.

Parametry opcjonalne

--item

Indeks elementu w zadaniu przetwarzania wsadowego.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az quantum job show

Wersja zapoznawcza

Grupa poleceń "quantum" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Uzyskaj stan i szczegóły zadania.

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

Przykłady

Uzyskaj stan zadania usługi Azure Quantum.

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

Parametry wymagane

--job-id -j

Unikatowy identyfikator zadania w formacie GUID.

--location -l

Lokalizacja. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--workspace-name -w

Nazwa obszaru roboczego quantum. Domyślny obszar roboczy można skonfigurować przy użyciu polecenia az quantum workspace set.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az quantum job submit

Wersja zapoznawcza

Grupa poleceń "quantum" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Prześlij program lub obwód do uruchomienia w usłudze Azure Quantum.

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]

Przykłady

Prześlij kod bitowy QIR z pliku w bieżącym folderze.

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

Prześlij zadanie przekazywania Quil do symulatora Rigetti.

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

Prześlij obwód Qiskit do symulatora IonQ z parametrami zadań.

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

Parametry wymagane

--job-input-file

Lokalizacja pliku wejściowego do przesłania.

--job-input-format

Format pliku do przesłania.

--location -l

Lokalizacja. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--target-id -t

Aparat wykonywania dla zadań obliczeń kwantowych. Po skonfigurowaniu obszaru roboczego z zestawem dostawców każda z nich włącza co najmniej jeden element docelowy. Domyślny element docelowy można skonfigurować przy użyciu polecenia az quantum target set.

--workspace-name -w

Nazwa obszaru roboczego quantum. Domyślny obszar roboczy można skonfigurować przy użyciu polecenia az quantum workspace set.

Parametry opcjonalne

--entry-point

Punkt wejścia dla programu QIR lub obwodu. Wymagane dla zadań QIR.

--job-name

Przyjazna nazwa do nadania temu uruchomieniu programu.

--job-output-format

Oczekiwany format danych wyjściowych zadania.

--job-params

Parametry zadania przekazywane do obiektu docelowego jako lista par key=value, ciągu json lub @{file} zawartości json.

--shots

Liczba uruchomień programu w danym obiekcie docelowym.

--storage

W przypadku określenia parametru ConnectionString usługi Azure Storage służy do przechowywania danych i wyników zadań.

--target-capability

Parametr możliwości docelowej przekazany do kompilatora.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az quantum job wait

Wersja zapoznawcza

Grupa poleceń "quantum" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu zakończenia działania zadania.

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

Przykłady

Poczekaj na ukończenie zadania, sprawdź 60 sekund interwałów.

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

Parametry wymagane

--job-id -j

Unikatowy identyfikator zadania w formacie GUID.

--location -l

Lokalizacja. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--workspace-name -w

Nazwa obszaru roboczego quantum. Domyślny obszar roboczy można skonfigurować przy użyciu polecenia az quantum workspace set.

Parametry opcjonalne

--max-poll-wait-secs

Czas sondowania w sekundach w celu wykonania zapytania względem usługi Azure Quantum w celu uzyskania wyników odpowiedniego zadania.

Domyślna wartość: 5
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.