Condividi tramite

az quantum job

  • Anteprima
  • Riferimento

Nota

Questo riferimento fa parte dell'estensione quantistica per l'interfaccia della riga di comando di Azure (versione 2.41.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az quantum job . Altre informazioni sulle estensioni.

Il gruppo di comandi 'quantum' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Gestire i processi per Azure Quantum.

Comandi

Nome Descrizione Tipo Status
az quantum job cancel

Richiedere di annullare un processo in Azure Quantum se non è stato completato.

 Estensione Anteprima
az quantum job list

Ottenere l'elenco dei processi in un'area di lavoro quantistica.

 Estensione Anteprima
az quantum job output

Ottenere i risultati dell'esecuzione di un processo.

 Estensione Anteprima
az quantum job show

Ottenere lo stato e i dettagli del processo.

 Estensione Anteprima
az quantum job submit

Inviare un programma o un circuito da eseguire in Azure Quantum.

 Estensione Anteprima
az quantum job wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino al termine dell'esecuzione del processo.

 Estensione Anteprima

az quantum job cancel

Anteprima

Il gruppo di comandi 'quantum' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Richiedere di annullare un processo in Azure Quantum se non è stato completato.

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

Esempio

Annullare un processo di Azure Quantum in base all'ID.

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

Parametri necessari

--job-id -j

Identificatore univoco del processo in formato GUID.

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--workspace-name -w

Nome dell'area di lavoro quantistica. È possibile configurare l'area di lavoro predefinita usando az quantum workspace set.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az quantum job list

Anteprima

Il gruppo di comandi 'quantum' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Ottenere l'elenco dei processi in un'area di lavoro quantistica.

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]

Esempio

Ottenere l'elenco dei processi da un'area di lavoro di Azure Quantum.

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

Elencare i processi che hanno usato il provider microsoft-elements.

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

Elencare i processi eseguiti nella destinazione microsoft.dft.

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

Elencare i processi completati correttamente.

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

Elencare i processi creati dopo il 15 gennaio 2025.

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

Elencare i processi i cui nomi iniziano con "Genera...".

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

Ignorare i primi 50 processi, iniziare a elencare i primi 51 processi ed elencare 10 processi.

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

Ordinare l'elenco di processi in base all'ID di destinazione e visualizzare in formato tabulare.

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

Ordinare l'elenco di processi in base al nome del processo in ordine decrescente, visualizzato in formato tabulare.

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

Parametri necessari

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--workspace-name -w

Nome dell'area di lavoro quantistica. È possibile configurare l'area di lavoro predefinita usando az quantum workspace set.

Parametri facoltativi

--created-after

Processi creati dopo questa data da elencare.

--created-before

Processi creati prima di questa data da elencare.

--item-type

Tipo di elemento da elencare, "processo" o "sessione".

--job-name

Nome descrittivo da assegnare a questa esecuzione del programma.

--job-type

Tipo di processo da elencare, ad esempio "QuantumComputing".

--order

Come ordinare l'elenco: asc o desc.

--orderby

Campo in cui ordinare l'elenco.

--provider-id -p

Identificatore di un provider Azure Quantum.

--skip

Numero di processi da ignorare durante la restituzione di un elenco di processi.

--status

Stato dei processi da elencare.

--target-id -t

Motore di esecuzione per i processi di calcolo quantistico. Quando un'area di lavoro è configurata con un set di provider, ognuna abilita una o più destinazioni. È possibile configurare la destinazione predefinita usando az quantum target set.

--top

Numero di processi elencati per pagina.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az quantum job output

Anteprima

Il gruppo di comandi 'quantum' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Ottenere i risultati dell'esecuzione di un processo.

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

Esempio

Stampare i risultati di un processo di Azure Quantum riuscito.

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

Parametri necessari

--job-id -j

Identificatore univoco del processo in formato GUID.

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--workspace-name -w

Nome dell'area di lavoro quantistica. È possibile configurare l'area di lavoro predefinita usando az quantum workspace set.

Parametri facoltativi

--item

Indice dell'elemento in un processo di invio in batch.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az quantum job show

Anteprima

Il gruppo di comandi 'quantum' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Ottenere lo stato e i dettagli del processo.

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

Esempio

Ottenere lo stato di un processo di Azure Quantum.

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

Parametri necessari

--job-id -j

Identificatore univoco del processo in formato GUID.

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--workspace-name -w

Nome dell'area di lavoro quantistica. È possibile configurare l'area di lavoro predefinita usando az quantum workspace set.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az quantum job submit

Anteprima

Il gruppo di comandi 'quantum' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Inviare un programma o un circuito da eseguire in 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]

Esempio

Inviare il codice bit QIR da un file nella cartella corrente.

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

Inviare un processo pass-through Quil al simulatore 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

Inviare un circuito Qiskit al simulatore IonQ con parametri di processo.

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

Parametri necessari

--job-input-file

Percorso del file di input da inviare.

--job-input-format

Formato del file da inviare.

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--target-id -t

Motore di esecuzione per i processi di calcolo quantistico. Quando un'area di lavoro è configurata con un set di provider, ognuna abilita una o più destinazioni. È possibile configurare la destinazione predefinita usando az quantum target set.

--workspace-name -w

Nome dell'area di lavoro quantistica. È possibile configurare l'area di lavoro predefinita usando az quantum workspace set.

Parametri facoltativi

--entry-point

Punto di ingresso per il programma o il circuito QIR. Obbligatorio per i processi QIR.

--job-name

Nome descrittivo da assegnare a questa esecuzione del programma.

--job-output-format

Formato di output del processo previsto.

--job-params

Parametri del processo passati alla destinazione come elenco di coppie chiave=valore, stringa json o @{file} con contenuto JSON.

--shots

Numero di volte in cui eseguire il programma nella destinazione specificata.

--storage

Se specificato, la proprietà ConnectionString di un Archiviazione di Azure viene utilizzata per archiviare i dati e i risultati del processo.

--target-capability

Parametro della funzionalità di destinazione passato al compilatore.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az quantum job wait

Anteprima

Il gruppo di comandi 'quantum' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino al termine dell'esecuzione del processo.

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

Esempio

Attendere il completamento di un processo, controllare a intervalli di 60 secondi.

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

Parametri necessari

--job-id -j

Identificatore univoco del processo in formato GUID.

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--workspace-name -w

Nome dell'area di lavoro quantistica. È possibile configurare l'area di lavoro predefinita usando az quantum workspace set.

Parametri facoltativi

--max-poll-wait-secs

Tempo di polling in secondi per eseguire query su Azure Quantum per ottenere i risultati del processo corrispondente.

Valore predefinito: 5
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.