你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。

az quantum workspace

Note

此引用是Azure CLI的 quantum 扩展的一部分(版本 2.73.0 或更高版本)。 该扩展将在首次运行 az quantum workspace 命令时自动安装。 了解更多关于扩展的信息。

命令组“quantum”处于预览状态,正在开发中。 参考和支持级别:https://aka.ms/CLI_refstatus

管理Azure Quantum工作区。

命令

名称 说明 类型 Status
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 workspace user

管理Azure Quantum工作区的用户。

Extension Preview
az quantum workspace user add

向用户授予对Azure Quantum工作区的访问权限。

Extension Preview
az quantum workspace user list

列出有权访问Azure Quantum工作区的用户。

Extension Preview
az quantum workspace user remove

删除用户对Azure Quantum工作区的访问权限。

Extension Preview

az quantum workspace clear

预览

命令组“quantum”处于预览状态,正在开发中。 参考和支持级别:https://aka.ms/CLI_refstatus

清除默认Azure Quantum工作区。

清除保存的资源组和工作区名称默认值。 其他设置(包括默认订阅、位置和目标)保持不变。

az quantum workspace clear [--acquire-policy-token]
                           [--change-reference]

示例

如果以前设置过,请清除默认Azure Quantum工作区。

az quantum workspace clear

可选参数

以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性 值
参数组: Global Policy Arguments
--change-reference

此资源操作的相关更改引用 ID。

属性 值
参数组: Global Policy Arguments
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误,禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az quantum workspace create

预览

命令组“quantum”处于预览状态,正在开发中。 参考和支持级别:https://aka.ms/CLI_refstatus

创建新的Azure Quantum工作区。

az quantum workspace create --location
                            --resource-group
                            --storage-account
                            --workspace-name
                            [--acquire-policy-token]
                            [--auto-accept]
                            [--change-reference]
                            [--provider-sku-list]
                            [--quota]
                            [--skip-autoadd]
                            [--skip-role-assignment]
                            [--workspace-kind {V1, V2}]

示例

使用提供免费额度的提供商创建新的Azure Quantum工作区。

az quantum workspace create -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -a MyStorageAccountName

使用特定提供程序列表创建新的Azure Quantum工作区。

az quantum workspace create -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -r "MyProvider1 / MySKU1, MyProvider2 / MySKU2" --skip-autoadd -a MyStorageAccountName

To display a list of available providers and their SKUs, use the following command:
    az quantum offerings list -l MyLocation -o table

创建具有提供程序目标的配额分配的 V2 工作区。

az quantum workspace create -g MyResourceGroup -w MyWorkspace -l MyLocation \
    --workspace-kind V2 -r "MyProvider/default" --skip-autoadd -a MyStorageAccountName \
    --quota provider-id=MyProvider target-id=MyProvider.Target1 standard-minutes-lifetime=500 high-minutes-lifetime=50 \
    --quota provider-id=MyProvider target-id=MyProvider.Target2 standard-minutes-lifetime=250

必需参数

--location -l

Location. az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

--storage-account -a

量子工作区要使用的存储帐户的名称。

--workspace-name -w

Quantum 工作区的名称。 可以使用 配置默认工作区 az quantum workspace set。

可选参数

以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性 值
参数组: Global Policy Arguments
--auto-accept

如果指定,则接受提供程序条款而不显示交互式 Y/N 提示符。

属性 值
默认值: False
--change-reference

此资源操作的相关更改引用 ID。

属性 值
参数组: Global Policy Arguments
--provider-sku-list -r

提供程序/SKU 对的逗号分隔列表。 使用斜杠分隔提供程序和 SKU。 将整个列表括在引号中。 来自 az quantum offerings list -l <location> -o table. 的值

--quota

将 V2 工作区的目标配额分配作为提供程序 ID、目标 ID、标准分钟生存期和可选的高分钟生存期键=值对、JSON 对象或数组,或者 @{file} 包含 JSON 内容。 创建工作区时使用 --workspace-kind V2。 值是绝对值,不能超过套件目标分配,或者在更新时低于当前工作区使用情况。 新分配需要标准分钟生存期。 也接受 camelCase 键(providerId、targetId、...)。 每个目标重复 --quota 一次。

--skip-autoadd

如果指定,则不会自动添加提供免费额度的计划。

属性 值
默认值: False
--skip-role-assignment

跳过存储帐户中量子工作区的角色分配步骤。

属性 值
默认值: False
--workspace-kind

要创建的工作区类型。 将 V2 用于 V2 提供程序和每个目标配额分配。

属性 值
接受的值: V1, V2
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误,禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az quantum workspace delete

预览

命令组“quantum”处于预览状态,正在开发中。 参考和支持级别:https://aka.ms/CLI_refstatus

删除给定的(或当前)Azure Quantum工作区。

az quantum workspace delete --resource-group
                            --workspace-name
                            [--acquire-policy-token]
                            [--change-reference]

示例

按资源组和工作区名称删除Azure Quantum工作区。 如果设置了默认工作区,则不需要 -g 和 -w 参数。

az quantum workspace delete -g MyResourceGroup -w MyWorkspace

必需参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

--workspace-name -w

Quantum 工作区的名称。 可以使用 配置默认工作区 az quantum workspace set。

可选参数

以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性 值
参数组: Global Policy Arguments
--change-reference

此资源操作的相关更改引用 ID。

属性 值
参数组: Global Policy Arguments
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误,禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az quantum workspace list

预览

命令组“quantum”处于预览状态,正在开发中。 参考和支持级别:https://aka.ms/CLI_refstatus

获取可用的Azure Quantum工作区列表。

az quantum workspace list [--location]
                          [--resource-group]
                          [--tag]

示例

获取所有可用Azure Quantum工作区的列表。

az quantum workspace list

获取位置中可用的Azure Quantum工作区的列表。

az quantum workspace list -l MyLocation

可选参数

以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。

--location -l

Location. az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

--tag

仅显示已关联指定标记的量子工作区。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误,禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az quantum workspace quotas

预览

命令组“quantum”处于预览状态,正在开发中。 参考和支持级别:https://aka.ms/CLI_refstatus

列出Azure Quantum工作区的配额分配和使用使用情况。

保留 V1 提供程序的现有配额维度响应。 对于 V2 提供程序,为每个目标返回单独的 StandardMinutesLifetime 和 HighMinutesLifetime 行,并按分钟报告 targetId、限制和利用率。 缺少的分配或使用情况值将返回为 0。

az quantum workspace quotas --resource-group
                            --workspace-name
                            [--acquire-policy-token]
                            [--change-reference]

示例

查看给定(或当前)工作区的配额分配和使用情况。 如果设置了默认工作区,则不需要 -g 和 -w 参数。

az quantum workspace quotas -g MyResourceGroup -w MyWorkspace -o table

必需参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

--workspace-name -w

Quantum 工作区的名称。 可以使用 配置默认工作区 az quantum workspace set。

可选参数

以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性 值
参数组: Global Policy Arguments
--change-reference

此资源操作的相关更改引用 ID。

属性 值
参数组: Global Policy Arguments
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误,禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az quantum workspace set

预览

命令组“quantum”处于预览状态,正在开发中。 参考和支持级别:https://aka.ms/CLI_refstatus

为将来的命令选择默认Azure Quantum工作区。

将资源组和工作区名称保存为永久性Azure CLI标志默认值。 资源组默认值与其他Azure CLI命令共享。 这些设置在终端会话之间保持。

显式 --resource-group 和 --workspace-name 参数分别替代各自的默认值。 面向另一个工作区的作业命令不会更改保存的默认值。

此命令不会更改默认订阅或位置。 使用“az quantum workspace clear”清除保存的资源组和 workspace-name 默认值。

az quantum workspace set --resource-group
                         --workspace-name
                         [--acquire-policy-token]
                         [--change-reference]

示例

设置默认Azure Quantum工作区。

az quantum workspace set -g MyResourceGroup -w MyWorkspace

必需参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

--workspace-name -w

Quantum 工作区的名称。 可以使用 配置默认工作区 az quantum workspace set。

可选参数

以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性 值
参数组: Global Policy Arguments
--change-reference

此资源操作的相关更改引用 ID。

属性 值
参数组: Global Policy Arguments
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误,禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az quantum workspace show

预览

命令组“quantum”处于预览状态,正在开发中。 参考和支持级别:https://aka.ms/CLI_refstatus

获取给定(或当前)Azure Quantum工作区的详细信息。

az quantum workspace show [--resource-group]
                          [--workspace-name]

示例

显示当前选定的默认Azure Quantum工作区。

az quantum workspace show

显示提供的Azure Quantum工作区的详细信息。

az quantum workspace show -g MyResourceGroup -w MyWorkspace

可选参数

以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

--workspace-name -w

Quantum 工作区的名称。 可以使用 配置默认工作区 az quantum workspace set。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误,禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az quantum workspace update

预览

命令组“quantum”处于预览状态,正在开发中。 参考和支持级别:https://aka.ms/CLI_refstatus

更新给定的(或当前)Azure Quantum工作区。

仅 V2 工作区支持通过“--quota”分配目标配额。

az quantum workspace update [--acquire-policy-token]
                            [--change-reference]
                            [--enable-api-key]
                            [--quota]
                            [--resource-group]
                            [--workspace-name]

示例

启用提供的Azure Quantum工作区 API 密钥。

az quantum workspace update --enable-api-key True

禁用提供的Azure Quantum工作区 API 密钥。

az quantum workspace update --enable-api-key False

更新 V2 工作区上的目标配额分配。

az quantum workspace update -g MyResourceGroup -w MyWorkspace \
    --quota provider-id=MyProvider target-id=MyProvider.Target1 standard-minutes-lifetime=1000

可选参数

以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性 值
参数组: Global Policy Arguments
--change-reference

此资源操作的相关更改引用 ID。

属性 值
参数组: Global Policy Arguments
--enable-api-key

启用或禁用 API 密钥身份验证。

--quota

将 V2 工作区的目标配额分配作为提供程序 ID、目标 ID、标准分钟生存期和可选的高分钟生存期键=值对、JSON 对象或数组,或者 @{file} 包含 JSON 内容。 创建工作区时使用 --workspace-kind V2。 值是绝对值,不能超过套件目标分配,或者在更新时低于当前工作区使用情况。 新分配需要标准分钟生存期。 也接受 camelCase 键(providerId、targetId、...)。 每个目标重复 --quota 一次。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

--workspace-name -w

Quantum 工作区的名称。 可以使用 配置默认工作区 az quantum workspace set。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误,禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False