Share via

az quantum

  • Preview
  • Reference

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.

This command group is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Manage Azure Quantum Workspaces and submit jobs to Azure Quantum Providers.

Commands

Name Description Type Status
az quantum execute

Submit a job to run on Azure Quantum, and wait for the result. Equivalent to az quantum run.

 Extension Preview
az quantum job

Manage jobs for Azure Quantum.

 Extension Preview
az quantum job cancel

Request to cancel a job on Azure Quantum if it hasn't completed.

 Extension Preview
az quantum job list

Get the list of jobs in a Quantum Workspace.

 Extension Preview
az quantum job output

Get the results of running a job.

 Extension Preview
az quantum job show

Get the job's status and details.

 Extension Preview
az quantum job submit

Submit a program or circuit to run on Azure Quantum.

 Extension Preview
az quantum job wait

Place the CLI in a waiting state until the job finishes running.

 Extension Preview
az quantum offerings

Manage provider offerings for Azure Quantum.

 Extension Preview
az quantum offerings accept-terms

Accept the terms of a provider and SKU combination to enable it for workspace creation.

 Extension Preview
az quantum offerings list

Get the list of all provider offerings available on the given location.

 Extension Preview
az quantum offerings show-terms

Show the terms of a provider and SKU combination including license URL and acceptance status.

 Extension Preview
az quantum run

Submit a job to run on Azure Quantum, and wait for the result. Equivalent to az quantum execute.

 Extension Preview
az quantum target

Manage targets for Azure Quantum workspaces.

 Extension Preview
az quantum target clear

Clear the default target-id.

 Extension Preview
az quantum target list

Get the list of providers and their targets in an Azure Quantum workspace.

 Extension Preview
az quantum target set

Select the default target to use when submitting jobs to Azure Quantum.

 Extension Preview
az quantum target show

Get the Target ID of the current default target to use when submitting jobs to Azure Quantum.

 Extension Preview
az quantum workspace

Manage Azure Quantum workspaces.

 Extension Preview
az quantum workspace clear

Clear the default Azure Quantum workspace.

 Extension Preview
az quantum workspace create

Create a new Azure Quantum workspace.

 Extension Preview
az quantum workspace delete

Delete the given (or current) Azure Quantum workspace.

 Extension Preview
az quantum workspace keys

Manage Azure Quantum Workspace api keys.

 Extension Preview
az quantum workspace keys list

List api keys for the given (or current) Azure Quantum workspace.

 Extension Preview
az quantum workspace keys regenerate

Regenerate api key for the given (or current) Azure Quantum workspace.

 Extension Preview
az quantum workspace list

Get the list of Azure Quantum workspaces available.

 Extension Preview
az quantum workspace quotas

List the quotas for the given (or current) Azure Quantum workspace.

 Extension Preview
az quantum workspace set

Select a default Azure Quantum workspace for future commands.

 Extension Preview
az quantum workspace show

Get the details of the given (or current) Azure Quantum workspace.

 Extension Preview
az quantum workspace update

Update the given (or current) Azure Quantum workspace.

 Extension Preview

az quantum execute

Preview

Command group 'quantum' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Submit a job to run on Azure Quantum, and wait for the result. Equivalent to 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]

Examples

Run QIR bitcode from a file in the current folder and wait for the result.

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

Run a Quil pass-through job on the Rigetti simulator and wait for the result.

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

Submit a Qiskit circuit to the IonQ simulator with job params and wait for the results.

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

Required Parameters

--job-input-file

The location of the input file to submit.

--job-input-format

The format of the file to submit.

--location -l

Location. Values from: az account list-locations. You can configure the default location using az configure --defaults location=<location>.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--target-id -t

Execution engine for quantum computing jobs. When a workspace is configured with a set of providers, they each enable one or more targets. You can configure the default target using az quantum target set.

--workspace-name -w

Name of the Quantum Workspace. You can configure the default workspace using az quantum workspace set.

Optional Parameters

--entry-point

The entry point for the QIR program or circuit. Required for QIR jobs.

--job-name

A friendly name to give to this run of the program.

--job-output-format

The expected job output format.

--job-params

Job parameters passed to the target as a list of key=value pairs, json string, or @{file} with json content.

--shots

The number of times to run the program on the given target.

--storage

If specified, the ConnectionString of an Azure Storage is used to store job data and results.

--target-capability

Target-capability parameter passed to the compiler.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az quantum run

Preview

Command group 'quantum' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Submit a job to run on Azure Quantum, and wait for the result. Equivalent to 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]

Examples

Run QIR bitcode from a file in the current folder and wait for the result.

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

Run a Quil pass-through job on the Rigetti simulator and wait for the result.

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

Submit a Qiskit circuit to the IonQ simulator with job params and wait for the results.

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

Required Parameters

--job-input-file

The location of the input file to submit.

--job-input-format

The format of the file to submit.

--location -l

Location. Values from: az account list-locations. You can configure the default location using az configure --defaults location=<location>.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--target-id -t

Execution engine for quantum computing jobs. When a workspace is configured with a set of providers, they each enable one or more targets. You can configure the default target using az quantum target set.

--workspace-name -w

Name of the Quantum Workspace. You can configure the default workspace using az quantum workspace set.

Optional Parameters

--entry-point

The entry point for the QIR program or circuit. Required for QIR jobs.

--job-name

A friendly name to give to this run of the program.

--job-output-format

The expected job output format.

--job-params

Job parameters passed to the target as a list of key=value pairs, json string, or @{file} with json content.

--shots

The number of times to run the program on the given target.

--storage

If specified, the ConnectionString of an Azure Storage is used to store job data and results.

--target-capability

Target-capability parameter passed to the compiler.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.