Condividi tramite

az quantum

  • Anteprima

Note

This reference is part of the quantum extension for the Azure CLI (version 2.41.0 or higher). The extension will automatically install the first time you run an az quantum command. Learn more about extensions.

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

Gestire le aree di lavoro di Azure Quantum e inviare processi ai provider di Azure Quantum.

Comandi

Nome Descrizione Tipo Status
az quantum execute

Inviare un processo per l'esecuzione in Azure Quantum e attendere il risultato. Equivalente a az quantum run.

 Extension Preview
az quantum job

Gestire i processi per Azure Quantum.

 Extension Preview
az quantum job cancel

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

 Extension Preview
az quantum job list

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

 Extension Preview
az quantum job output

Ottenere i risultati dell'esecuzione di un processo.

 Extension Preview
az quantum job show

Ottenere lo stato e i dettagli del processo.

 Extension Preview
az quantum job submit

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

 Extension Preview
az quantum job wait

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

 Extension Preview
az quantum offerings

Gestire le offerte del provider per Azure Quantum.

 Extension Preview
az quantum offerings accept-terms

Accettare le condizioni di una combinazione di provider e SKU per abilitarla per la creazione dell'area di lavoro.

 Extension Preview
az quantum offerings list

Ottenere l'elenco di tutte le offerte del provider disponibili nella posizione specificata.

 Extension Preview
az quantum offerings show-terms

Mostra le condizioni di una combinazione di provider e SKU, inclusi l'URL della licenza e lo stato di accettazione.

 Extension Preview
az quantum run

Inviare un processo per l'esecuzione in Azure Quantum e attendere il risultato. Equivalente a az quantum execute.

 Extension Preview
az quantum target

Gestire le destinazioni per le aree di lavoro di Azure Quantum.

 Extension Preview
az quantum target clear

Deselezionare l'ID di destinazione predefinito.

 Extension Preview
az quantum target list

Ottenere l'elenco dei provider e delle relative destinazioni in un'area di lavoro di Azure Quantum.

 Extension Preview
az quantum target set

Selezionare la destinazione predefinita da usare quando si inviano processi ad Azure Quantum.

 Extension Preview
az quantum target show

Ottenere l'ID di destinazione della destinazione predefinita corrente da usare quando si inviano processi ad Azure Quantum.

 Extension Preview
az quantum workspace

Gestire le aree di lavoro di Azure Quantum.

 Extension Preview
az quantum workspace clear

Cancellare l'area di lavoro predefinita di Azure Quantum.

 Extension Preview
az quantum workspace create

Creare una nuova area di lavoro di Azure Quantum.

 Extension Preview
az quantum workspace delete

Eliminare l'area di lavoro di Azure Quantum specificata (o corrente).

 Extension Preview
az quantum workspace keys

Gestire le chiavi API dell'area di lavoro di Azure Quantum.

 Extension Preview
az quantum workspace keys list

Elencare le chiavi API per l'area di lavoro di Azure Quantum specificata (o corrente).

 Extension Preview
az quantum workspace keys regenerate

Rigenerare la chiave API per l'area di lavoro di Azure Quantum specificata (o corrente).

 Extension Preview
az quantum workspace list

Ottenere l'elenco delle aree di lavoro di Azure Quantum disponibili.

 Extension Preview
az quantum workspace quotas

Elencare le quote per l'area di lavoro di Azure Quantum specificata (o corrente).

 Extension Preview
az quantum workspace set

Selezionare un'area di lavoro di Azure Quantum predefinita per i comandi futuri.

 Extension Preview
az quantum workspace show

Ottenere i dettagli dell'area di lavoro di Azure Quantum specificata (o corrente).

 Extension Preview
az quantum workspace update

Aggiornare l'area di lavoro di Azure Quantum specificata (o corrente).

 Extension Preview

az quantum execute

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 processo per l'esecuzione in Azure Quantum e attendere il risultato. Equivalente a az quantum run.

az quantum execute --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

Eseguire il codice bit QIR da un file nella cartella corrente e attendere il risultato.

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

Eseguire un processo pass-through Quil nel simulatore Rigetti e attendere il risultato.

az quantum execute -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 e attendere i risultati.

az quantum execute -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

Location. Usare i valori ottenuti con az account list-locations. È possibile configurare il percorso predefinito usando az configure --defaults location=<location>.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando 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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Output format.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--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

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

Proprietà Valore
Valore predefinito: False

az quantum run

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 processo per l'esecuzione in Azure Quantum e attendere il risultato. Equivalente a az quantum execute.

az quantum run --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

Eseguire il codice bit QIR da un file nella cartella corrente e attendere il risultato.

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

Eseguire un processo pass-through Quil nel simulatore Rigetti e attendere il risultato.

az quantum run -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 e attendere i risultati.

az quantum run -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

Location. Usare i valori ottenuti con az account list-locations. È possibile configurare il percorso predefinito usando az configure --defaults location=<location>.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando 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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Output format.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--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

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

Proprietà Valore
Valore predefinito: False