az quantum
Note
此引用是Azure CLI的 quantum 扩展的一部分(版本 2.73.0 或更高版本)。 该扩展将在首次运行 az quantum 命令时自动安装。 了解更多关于扩展的信息。
此命令组处于预览状态,正在开发中。 参考和支持级别:https://aka.ms/CLI_refstatus
管理Azure Quantum工作区并将作业提交到Azure Quantum提供程序。
命令
| 名称 | 说明 | 类型 | Status |
|---|---|---|---|
| az quantum execute |
提交要在Azure Quantum上运行的作业,并等待结果。 等效于 |
Extension | Preview |
| az quantum job |
管理Azure Quantum的作业。 |
Extension | Preview |
| az quantum job cancel |
如果作业尚未完成,则请求取消Azure Quantum作业。 |
Extension | Preview |
| az quantum job list |
获取 Quantum 工作区中的作业列表。 |
Extension | Preview |
| az quantum job output |
获取运行作业的结果。 |
Extension | Preview |
| az quantum job show |
获取作业的状态和详细信息。 |
Extension | Preview |
| az quantum job submit |
提交要在Azure Quantum上运行的程序或线路。 |
Extension | Preview |
| az quantum job wait |
将 CLI 置于等待状态,直到作业完成运行。 |
Extension | Preview |
| az quantum offerings |
管理Azure Quantum的提供商产品/服务。 |
Extension | Preview |
| az quantum offerings accept-terms |
接受提供程序和 SKU 组合的条款,以启用它以创建工作区。 |
Extension | Preview |
| az quantum offerings list |
获取给定位置上提供的所有提供商产品/服务的列表。 |
Extension | Preview |
| az quantum offerings show-terms |
显示提供商和 SKU 组合的条款,包括许可证 URL 和接受状态。 |
Extension | Preview |
| az quantum run |
提交要在Azure Quantum上运行的作业,并等待结果。 等效于 |
Extension | Preview |
| az quantum target |
管理Azure Quantum工作区的目标。 |
Extension | Preview |
| az quantum target clear |
清除默认目标 ID。 |
Extension | Preview |
| az quantum target list |
获取Azure Quantum工作区中的提供程序及其目标列表。 |
Extension | Preview |
| az quantum target set |
选择要在将作业提交到Azure Quantum时使用的默认目标。 |
Extension | Preview |
| az quantum target show |
获取将作业提交到Azure Quantum时要使用的当前默认目标的目标 ID。 |
Extension | Preview |
| az quantum workspace |
管理Azure Quantum工作区。 |
Extension | Preview |
| az quantum workspace clear |
清除默认Azure Quantum工作区。 |
Extension | Preview |
| az quantum workspace create |
创建新的Azure Quantum工作区。 |
Extension | Preview |
| az quantum workspace delete |
删除给定的(或当前)Azure Quantum工作区。 |
Extension | Preview |
| az quantum workspace keys |
管理Azure Quantum工作区 API 密钥。 |
Extension | Preview |
| az quantum workspace keys list |
列出给定(或当前)Azure Quantum工作区的 API 密钥。 |
Extension | Preview |
| az quantum workspace keys regenerate |
重新生成给定(或当前)Azure Quantum工作区的 API 密钥。 |
Extension | Preview |
| az quantum workspace list |
获取可用的Azure Quantum工作区列表。 |
Extension | Preview |
| az quantum workspace quotas |
列出给定(或当前)Azure Quantum工作区的配额。 |
Extension | Preview |
| az quantum workspace set |
为将来的命令选择默认Azure Quantum工作区。 |
Extension | Preview |
| az quantum workspace show |
获取给定(或当前)Azure Quantum工作区的详细信息。 |
Extension | Preview |
| az quantum workspace update |
更新给定的(或当前)Azure Quantum工作区。 |
Extension | Preview |
az quantum execute
命令组“quantum”处于预览状态,正在开发中。 参考和支持级别:https://aka.ms/CLI_refstatus
提交要在Azure Quantum上运行的作业,并等待结果。 等效于 az quantum run。
az quantum execute --job-input-file
--job-input-format
--resource-group
--target-id
--workspace-name
[--acquire-policy-token]
[--change-reference]
[--entry-point]
[--job-name]
[--job-output-format]
[--job-params]
[--location]
[--shots]
[--storage]
[--target-capability]
[]
示例
从当前文件夹中的文件运行 QIR 位代码并等待结果。
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
在 Rigetti 模拟器上运行 Quil 直通作业并等待结果。
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
使用作业参数将 Qiskit 线路提交到 IonQ 模拟器,并等待结果。
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
必需参数
要提交的输入文件的位置。
要提交的文件格式。
资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。
量子计算作业的执行引擎。 使用一组提供程序配置工作区时,它们各自启用一个或多个目标。 可以使用 .. 配置默认目标 az quantum target set。
Quantum 工作区的名称。 可以使用 配置默认工作区 az quantum workspace set。
可选参数
以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。
为此资源操作自动获取Azure Policy令牌。
| 属性 | 值 |
|---|---|
| 参数组: | Global Policy Arguments |
此资源操作的相关更改引用 ID。
| 属性 | 值 |
|---|---|
| 参数组: | Global Policy Arguments |
QIR 程序或线路的入口点。 某些提供程序 QIR 作业是必需的。
要为此程序运行的友好名称。
预期的作业输出格式。
作为 key=value pairs、json 字符串或 @{file} json 内容的列表传递给目标的作业参数。
选项“--location”已弃用,将于 2026 年 5 月删除。
Location.
az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。
在给定的目标上运行程序的次数。
如果指定,则Azure 存储的 ConnectionString 用于存储作业数据和结果。
传递给编译器的目标功能参数。
Location.
az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
az quantum run
命令组“quantum”处于预览状态,正在开发中。 参考和支持级别:https://aka.ms/CLI_refstatus
提交要在Azure Quantum上运行的作业,并等待结果。 等效于 az quantum execute。
az quantum run --job-input-file
--job-input-format
--resource-group
--target-id
--workspace-name
[--acquire-policy-token]
[--change-reference]
[--entry-point]
[--job-name]
[--job-output-format]
[--job-params]
[--location]
[--shots]
[--storage]
[--target-capability]
[]
示例
从当前文件夹中的文件运行 QIR 位代码并等待结果。
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
在 Rigetti 模拟器上运行 Quil 直通作业并等待结果。
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
使用作业参数将 Qiskit 线路提交到 IonQ 模拟器,并等待结果。
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
必需参数
要提交的输入文件的位置。
要提交的文件格式。
资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。
量子计算作业的执行引擎。 使用一组提供程序配置工作区时,它们各自启用一个或多个目标。 可以使用 .. 配置默认目标 az quantum target set。
Quantum 工作区的名称。 可以使用 配置默认工作区 az quantum workspace set。
可选参数
以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。
为此资源操作自动获取Azure Policy令牌。
| 属性 | 值 |
|---|---|
| 参数组: | Global Policy Arguments |
此资源操作的相关更改引用 ID。
| 属性 | 值 |
|---|---|
| 参数组: | Global Policy Arguments |
QIR 程序或线路的入口点。 某些提供程序 QIR 作业是必需的。
要为此程序运行的友好名称。
预期的作业输出格式。
作为 key=value pairs、json 字符串或 @{file} json 内容的列表传递给目标的作业参数。
选项“--location”已弃用,将于 2026 年 5 月删除。
Location.
az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。
在给定的目标上运行程序的次数。
如果指定,则Azure 存储的 ConnectionString 用于存储作业数据和结果。
传递给编译器的目标功能参数。
参数“--location”已弃用,将于 2026 年 5 月删除。
Location.
az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |