From 2bb98024cc345a5cec7f4d80f9856721b86c028d Mon Sep 17 00:00:00 2001
From: Machiavelli <145562237+MachiavelliII@users.noreply.github.com>
Date: Fri, 30 May 2025 21:31:31 +0300
Subject: [PATCH] az-quantum: add page (#16630)

---
 pages/common/az-quantum.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 pages/common/az-quantum.md

diff --git a/pages/common/az-quantum.md b/pages/common/az-quantum.md
new file mode 100644
index 0000000000..ab63e4f89c
--- /dev/null
+++ b/pages/common/az-quantum.md
@@ -0,0 +1,36 @@
+# az quantum
+
+> Manage Azure Quantum workspaces and submit quantum jobs to providers (preview, requires quantum extension).
+> More information: <https://learn.microsoft.com/cli/azure/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}}`
+
+- List all Azure Quantum workspaces:
+
+`az quantum workspace list`
+
+- Set a default Azure Quantum workspace:
+
+`az quantum workspace set {{[-g|--resource-group]}} {{ResourceGroup}} {{[-w|--workspace-name]}} {{Workspace}}`
+
+- Submit a QIR quantum job to a target:
+
+`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}}`
+
+- List all jobs in a Quantum Workspace:
+
+`az quantum job list {{[-g|--resource-group]}} {{ResourceGroup}} {{[-l|--location]}} {{Location}} {{[-w|--workspace-name]}} {{Workspace}}`
+
+- Get the output of a quantum job:
+
+`az quantum job output {{[-g|--resource-group]}} {{ResourceGroup}} {{[-w|--workspace-name]}} {{Workspace}} --job-id {{Job}}`
+
+- List available provider offerings in a location:
+
+`az quantum offerings list {{[-l|--location]}} {{Location}}`
+
+- Set a default target for job submissions:
+
+`az quantum target set {{[-t|--target-id]}} {{Id}}`