az-quantum

Create a new Azure Quantum workspace

$ az quantum workspace create [[-g|--resource-group]] [ResourceGroup] [[-l|--location]] [Location] [[-w|--workspace-name]] [Workspace] [[-a|--storage-account]] [MyStorageAccountName]

$ az quantum workspace list

$ az quantum workspace set [[-g|--resource-group]] [ResourceGroup] [[-w|--workspace-name]] [Workspace]

$ az quantum job submit [[-g|--resource-group]] [ResourceGroup] [[-w|--workspace-name]] [Workspace] [[-l|--location]] [Location] [[-t|--target-id]] [Id] --job-name [Job] --job-input-file [QirBitcode.bc] --job-input-format [qir.v1]

$ az quantum job list [[-g|--resource-group]] [ResourceGroup] [[-l|--location]] [Location] [[-w|--workspace-name]] [Workspace]

$ az quantum job output [[-g|--resource-group]] [ResourceGroup] [[-w|--workspace-name]] [Workspace] --job-id [Job]

$ az quantum offerings list [[-l|--location]] [Location]

$ az quantum target set [[-t|--target-id]] [Id]

az quantum [--debug] [--help -h] [--only-show-errors] [--output -o] [--query -q] [--subscription] [--verbose] <subcommand>

--debug
    Increase logging verbosity to show all debug logs. Use for troubleshooting cloud issues.


--help -h
    Show help for az quantum and exit.

--only-show-errors
    Show only errors, suppressing warnings.

--output -o
    Output format: json, jsonc, table, tsv, yaml.

--query -q
    JMESPath query string to customize output.

--subscription
    Azure subscription ID to target.

--verbose
    Increase logging verbosity.

az quantum is the Azure CLI extension command group for managing Azure Quantum, Microsoft's cloud-based quantum computing platform. It enables developers to create quantum workspaces, discover available hardware from providers like IonQ, Quantinuum, and Rigetti, submit and monitor jobs in Q# or Qiskit, retrieve results, and manage models.

The service supports hybrid quantum-classical workflows, allowing scalable execution on diverse quantum processors without local hardware. Users can list providers with az quantum provider list, create workspaces via az quantum workspace create, and submit jobs using az quantum job submit.

Prerequisites: Install Azure CLI, add the quantum extension (az extension add --name quantum), and authenticate (az login). Ideal for researchers and developers prototyping quantum algorithms in the cloud.

Key benefits include pay-per-shot pricing, seamless integration with Azure tools, and support for open-source frameworks, accelerating quantum app development.

Requires Azure CLI v2.20+ and az extension add --name quantum --upgrade. Needs active subscription and az login. Some features preview-only; check Azure docs for quotas.

az extension add --name quantum --upgrade to install/update.

workspace (manage workspaces), job (submit/monitor jobs), provider (list providers), hardware (list hardware), submission (machine configs), model (Q# models). Use az quantum --help for details.

Launched in 2021 public preview alongside Azure Quantum service. Extension evolved with provider integrations (IonQ 2021, Quantinuum 2022). Regular updates via Azure CLI releases.

az(1)