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 Stato
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 sottoscrizione predefinita 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

Esempio

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

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

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 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 sottoscrizione predefinita 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 sottoscrizione predefinita 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 sottoscrizione predefinita 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 --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>]

Esempio

Inviare un programma Q# dalla cartella corrente.

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

Inviare un programma Q# dalla cartella corrente con parametri di processo per una destinazione.

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

Inviare un programma Q# con parametri di programma (ad esempio n-qubit = 2).

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

Inviare un programma Q# dalla cartella corrente con un parametro di funzionalità di destinazione.

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

Inviare codice LLVM leggibile o codice 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

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

--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 QIR. Ignorato nei processi Q#.

--job-input-file

Percorso del file di input da inviare. Obbligatorio per i processi QIR, QIO e pass-through. Ignorato nei processi Q#.

--job-input-format

Formato del file da inviare. Omettere questo parametro nei processi Q#.

--job-name

Nome descrittivo da assegnare a questa esecuzione del programma.

--job-output-format

Formato di output del processo previsto. Ignorato nei processi Q#.

--job-params

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

--no-build

[Deprecato] Se specificato, il programma Q# non viene compilato prima dell'invio.

valore predefinito: False
--project

[Deprecato] Percorso del progetto Q# da inviare. Il valore predefinito è la cartella corrente.

--shots

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

--storage

Se specificato, la Connessione ionString di un Archiviazione di Azure viene usata per archiviare i dati e i risultati del processo.

--target-capability

Parametro della funzionalità di destinazione passato al compilatore.

<PROGRAM_ARGS>

Elenco di argomenti previsti dall'operazione Q# specificata come --name=value dopo --.

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 sottoscrizione predefinita 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 sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

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