你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
az ml model
注意
此参考是 Azure CLI(版本 2.0.28 或更高版本)的 azure-cli-ml 扩展的一部分。 该扩展将在首次运行 az ml model 命令时自动安装。 详细了解扩展。
管理机器学习模型。
命令
名称 | 说明 | 类型 | Status |
---|---|---|---|
az ml model delete |
从工作区中删除模型。 |
扩展 | GA |
az ml model deploy |
从工作区部署模型(s)。 |
扩展 | GA |
az ml model download |
从工作区下载模型。 |
扩展 | GA |
az ml model list |
列出工作区中的模型。 |
扩展 | GA |
az ml model package |
在工作区中打包模型。 |
扩展 | GA |
az ml model profile |
工作区中的配置文件模型。 |
扩展 | GA |
az ml model register |
将模型注册到工作区。 |
扩展 | GA |
az ml model show |
在工作区中显示模型。 |
扩展 | GA |
az ml model update |
更新工作区中的模型。 |
扩展 | GA |
az ml model delete
从工作区中删除模型。
az ml model delete --model-id
[--path]
[--resource-group]
[--subscription-id]
[--workspace-name]
[-v]
必需参数
要删除的模型的 ID。
可选参数
项目文件夹的路径。 默认值:当前目录。
与提供的工作区对应的资源组。
指定订阅 ID。
工作区的名称。
详细标志。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az ml model deploy
从工作区部署模型(s)。
az ml model deploy --name
[--ae]
[--ai]
[--ar]
[--as]
[--at]
[--autoscale-max-replicas]
[--autoscale-min-replicas]
[--base-image]
[--base-image-registry]
[--cc]
[--ccl]
[--cf]
[--collect-model-data]
[--compute-target]
[--compute-type]
[--cuda-version]
[--dc]
[--description]
[--dn]
[--ds]
[--ed]
[--eg]
[--entry-script]
[--environment-name]
[--environment-version]
[--failure-threshold]
[--gb]
[--gbl]
[--gc]
[--ic]
[--id]
[--key-name]
[--key-version]
[--kp]
[--ks]
[--lo]
[--max-request-wait-time]
[--model]
[--model-metadata-file]
[--namespace]
[--no-wait]
[--nr]
[--overwrite]
[--path]
[--period-seconds]
[--pi]
[--po]
[--property]
[--replica-max-concurrent-requests]
[--resource-group]
[--rt]
[--sc]
[--scoring-timeout-ms]
[--sd]
[--se]
[--sk]
[--sp]
[--st]
[--subnet-name]
[--subscription-id]
[--tag]
[--timeout-seconds]
[--token-auth-enabled]
[--tp]
[--vault-base-url]
[--version-name]
[--vnet-name]
[--workspace-name]
[-v]
必需参数
部署的服务的名称。
可选参数
是否为此 Webservice 启用密钥身份验证。 默认为 False。
是否为此 Webservice 启用 AppInsights。 默认为 False。
自动缩放程序应尝试缩放此 Webservice 的频率。 默认值为 1。
是否为此 Web 服务启用自动缩放。 如果 num_replicas 为 None,则默认值为 True。
自动缩放程序应尝试维持此 Web 服务的目标利用率(低于 100%)。 默认值为 70。
自动缩放此 Webservice 时要使用的容器的最大数目。 默认值为 10。
自动缩放此 Webservice 时要使用的容器的最小数目。 默认值为 1。
用作基础映像的自定义映像。 如果未提供基础映像,则基于给定的运行时参数使用基础映像。
包含基础映像的映像注册表。
要分配给此 Webservice 的 CPU 核心数。 可以是小数。 默认值为 0.1。
允许此 Web 服务使用的最大 CPU 核心数。 可以是小数。
包含要用于映像的 conda 环境定义的本地文件的路径。
是否为此 Web 服务启用模型数据收集。 默认为 False。
计算目标的名称。 仅适用于部署到 AKS 时。
要部署的服务的计算类型。
要为需要 GPU 支持的映像安装 CUDA 版本。 GPU 映像必须用于 Azure 容器实例、Azure 机器学习计算、Azure 虚拟机和 Azure Kubernetes 服务等 Microsoft Azure 服务。 支持的版本为 9.0、9.1 和 10.0。 如果设置了“enable_gpu”,则默认值为“9.1”。
包含部署元数据的 JSON 或 YAML 文件的路径。
已部署的服务的说明。
此 Web 服务的 dns 名称。
本地文件的路径,其中包含设置映像时要运行的其他 Docker 步骤。
用于部署Azure 机器学习环境的目录。 它与“az ml environment scaffold”命令中提供的目录路径相同。
是否在映像中启用 GPU 支持。 GPU 映像必须用于 Azure 容器实例、Azure 机器学习计算、Azure 虚拟机和 Azure Kubernetes 服务等 Microsoft Azure 服务。 默认为 False。
包含要为服务运行的代码的本地文件的路径(如果提供了source_directory的相对路径)。
用于部署Azure 机器学习环境的名称。
用于部署的现有Azure 机器学习环境的版本。
当 Pod 启动且运行情况探测失败时,Kubernetes 会在放弃之前尝试 --failure-threshold times。 默认值为 3。 最小值为 1。
为此 Webservice 分配的内存量 (GB)。 可以是小数。
允许此 Web 服务使用的最大内存量 (GB)。 可以是小数。
要为此 Web 服务分配的 gpu 核心数。 默认值为 1。
包含推理配置的 JSON 或 YAML 文件的路径。
启动容器后,启动运行情况探测前的秒数。 默认值为 310。
ACI 的客户管理的密钥(CMK)中加密属性的密钥名称。
用于 ACI 的客户管理的密钥(CMK)中加密属性的密钥版本。
要用于此 Webservice 的主要身份验证密钥。
要用于此 Webservice 的辅助身份验证密钥。
要将此 Webservice 部署到的 Azure 区域。 如果未指定,将使用工作区位置。 有关可用区域的更多详细信息,可在此处找到: https://azure.microsoft.com/en-us/global-infrastructure/services/?regions=all&products=container-instances。
在返回 503 错误之前,请求将在队列中停留的最长时间(以毫秒为单位)。 默认为 500。
要部署的模型的 ID。 可以使用其他 -m 参数指定多个模型。 模型需要首先注册。
包含模型注册元数据的 JSON 文件的路径。 可以使用多个 -f 参数提供多个模型。
要在其中部署服务的 Kubernetes 命名空间:最多 63 个小写字母数字 ('a'-'z', '0'-'9') 和连字符 ('-') 字符。 第一个和最后一个字符不能为连字符。 仅适用于部署到 AKS 时。
标志不等待异步调用。
要分配给此 Webservice 的容器数量。 无默认值,如果未设置此参数,则默认启用自动缩放程序。
如果名称冲突,请覆盖现有服务。
项目文件夹的路径。 默认值:当前目录。
执行运行情况探测的频率(秒)。 默认值为 10 秒。 最小值为 1。
包含分析结果的 JSON 文件的路径。
用于公开服务的 HTTP 终结点的本地端口。
要添加的键/值属性(e.g. key=value )。 可以使用多个 --property 选项指定多个属性。
允许此 Web 服务的每个节点的最大并发请求数。 默认值为 1。
与提供的工作区对应的资源组。
要用于映像的运行时。 当前支持的运行时为“spark-py”和“python”spark-py|python|python-slim。
启用 SSL 时的 cname。
对此 Webservice 的评分调用强制执行的超时时间。 默认值为 60000。
包含要创建映像的所有文件的文件夹的路径。
是否为此 Webservice 启用 SSL。 默认为 False。
如果启用了 SSL,则需要密钥文件。
如果启用了 SSL,则需要证书文件。
运行情况探测失败后,将其视为成功所需的最小连续成功次数。 默认值为 1。 最小值为 1。
VNet 内子网的名称。
指定订阅 ID。
要添加的键/值标记(e.g. key=value )。 可以使用多个 --tag 选项指定多个标记。
运行情况探测超时前等待的秒数。默认值为 2 秒。 最小值为 1。
是否为此 Web 服务启用令牌身份验证。 如果未部署到 AKS,则忽略。 默认为 False。
版本在终结点中接收的流量。 可以是小数。 默认值为 0。
ACI 的客户管理的密钥(CMK)中加密属性的保管库基 URL。
终结点中的版本名称。 默认为第一个版本的终结点名称。
虚拟网络的名称。
工作区的名称。
详细标志。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az ml model download
从工作区下载模型。
az ml model download --model-id
--target-dir
[--overwrite]
[--path]
[--resource-group]
[--subscription-id]
[--workspace-name]
[-v]
必需参数
模型的 ID。
要下载模型文件的目标目录。
可选参数
如果目标目录中存在同一名称文件,则覆盖。
项目文件夹的路径。 默认值:当前目录。
与提供的工作区对应的资源组。
指定订阅 ID。
包含要显示的模型的工作区的名称。
详细标志。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az ml model list
列出工作区中的模型。
az ml model list [--dataset-id]
[--latest]
[--model-name]
[--path]
[--property]
[--resource-group]
[--run-id]
[--subscription-id]
[--tag]
[--workspace-name]
[-v]
可选参数
如果提供,将仅显示具有指定数据集 ID 的模型。
如果提供,则仅返回具有最新版本的模型。
用于筛选列表的可选模型名称。
项目文件夹的路径。 默认值:当前目录。
要添加的键/值属性(e.g. key=value )。 可以使用多个 --property 选项指定多个属性。
与提供的工作区对应的资源组。
如果提供,将仅显示具有指定运行 ID 的模型。
指定订阅 ID。
要添加的键/值标记(e.g. key=value )。 可以使用多个 --tag 选项指定多个标记。
包含要列出的模型的工作区的名称。
详细标志。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az ml model package
在工作区中打包模型。
az ml model package [--cf]
[--ed]
[--entry-script]
[--environment-name]
[--environment-version]
[--ic]
[--il]
[--image-name]
[--model]
[--model-metadata-file]
[--no-wait]
[--output-path]
[--path]
[--resource-group]
[--rt]
[--sd]
[--subscription-id]
[--workspace-name]
[-v]
可选参数
包含要用于包的 conda 环境定义的本地文件的路径。
用于打包Azure 机器学习环境的目录。 它与“az ml environment scaffold”命令中提供的目录路径相同。
包含要为服务运行的代码的本地文件的路径(如果提供了source_directory的相对路径)。
用于打包Azure 机器学习环境的名称。
用于打包的现有Azure 机器学习环境的版本。
包含推理配置的 JSON 或 YAML 文件的路径。
用于提供生成的包映像的标签。
用于提供生成的包映像的名称。
要打包的模型的 ID。 可以使用其他 -m 参数指定多个模型。 模型需要首先注册。
包含模型注册元数据的 JSON 文件的路径。 可以使用多个 -f 参数提供多个模型。
标志不等待异步调用。
Docker 上下文的输出路径。 如果传递输出路径,而不是在工作区 ACR 中生成映像,dockerfile 和必要的生成上下文将写入该路径。
项目文件夹的路径。 默认值:当前目录。
与提供的工作区对应的资源组。
要用于包的运行时。 当前支持的运行时为“spark-py”和“python”spark-py|python|python-slim。
包含要创建映像的所有文件的文件夹的路径。
指定订阅 ID。
工作区的名称。
详细标志。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az ml model profile
工作区中的配置文件模型。
az ml model profile --name
[--base-image]
[--base-image-registry]
[--cc]
[--cf]
[--description]
[--ed]
[--entry-script]
[--environment-name]
[--environment-version]
[--gb]
[--ic]
[--idi]
[--model]
[--model-metadata-file]
[--output-metadata-file]
[--resource-group]
[--sd]
[--subscription-id]
[--workspace-name]
[-v]
必需参数
模型配置文件的名称。
可选参数
用作基础映像的自定义映像。 如果未提供基础映像,则基于给定的运行时参数使用基础映像。
包含基础映像的映像注册表。
分析时要使用的最大 CPU 的双精度值。
包含要用于映像的 conda 环境定义的本地文件的路径。
模型配置文件的说明。
用于部署Azure 机器学习环境的目录。 它与“az ml environment scaffold”命令中提供的目录路径相同。
包含要为服务运行的代码的本地文件的路径(如果提供了source_directory的相对路径)。
用于部署Azure 机器学习环境的名称。
用于部署的现有Azure 机器学习环境的版本。
分析时要使用的最大内存的双精度值。
包含推理配置的 JSON 或 YAML 文件的路径。
要用作配置文件输入的表格数据集的 ID。
要部署的模型的 ID。 可以使用其他 -m 参数指定多个模型。 模型需要首先注册。
包含模型注册元数据的 JSON 文件的路径。 可以使用多个 -f 参数提供多个模型。
将写入配置文件结果元数据的 JSON 文件的路径。 用作模型部署的输入。
与提供的工作区对应的资源组。
包含要创建映像的所有文件的文件夹的路径。
指定订阅 ID。
工作区的名称。
详细标志。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az ml model register
将模型注册到工作区。
az ml model register --name
[--asset-path]
[--cc]
[--description]
[--experiment-name]
[--gb]
[--gc]
[--model-framework]
[--model-framework-version]
[--model-path]
[--output-metadata-file]
[--path]
[--property]
[--resource-group]
[--run-id]
[--run-metadata-file]
[--sample-input-dataset-id]
[--sample-output-dataset-id]
[--subscription-id]
[--tag]
[--workspace-name]
[-v]
必需参数
要注册的模型的名称。
可选参数
体验运行存储模型文件的云路径。
要为此模型分配的默认 CPU 核心数。 可以是小数。
模型的说明。
试验的名称。
要为此模型分配的默认内存量(以 GB 为单位)。 可以是小数。
要为此模型分配的默认 GPU 数。
要注册的模型的框架。 当前支持的框架:TensorFlow、ScikitLearn、Onnx、Custom、Multi。
要注册的模型的框架版本(例如 1.0.0、2.4.1)。
要注册的模型文件的完整路径。
要在其中写入模型注册元数据的 JSON 文件的路径。 用作模型部署的输入。
项目文件夹的路径。 默认值:当前目录。
要添加的键/值属性(e.g. key=value )。 可以使用多个 --property 选项指定多个属性。
与提供的工作区对应的资源组。
从中注册模型的试验运行的 ID。
包含体验运行元数据的 JSON 文件的路径。
示例输入数据集的 ID。
示例输出数据集的 ID。
指定订阅 ID。
要添加的键/值标记(e.g. key=value )。 可以使用多个 --tag 选项指定多个标记。
要在其中注册此模型的工作区的名称。
详细标志。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az ml model show
在工作区中显示模型。
az ml model show [--model-id]
[--model-name]
[--path]
[--resource-group]
[--run-id]
[--subscription-id]
[--version]
[--workspace-name]
[-v]
可选参数
要显示的模型的 ID。
要显示的模型的名称。
项目文件夹的路径。 默认值:当前目录。
与提供的工作区对应的资源组。
如果提供,将仅显示具有指定运行 ID 的模型。
指定订阅 ID。
如果提供,将仅显示具有指定名称和版本的模型。
包含要显示的模型的工作区的名称。
详细标志。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az ml model update
更新工作区中的模型。
az ml model update --model-id
[--add-property]
[--add-tag]
[--cc]
[--description]
[--gb]
[--gc]
[--path]
[--remove-tag]
[--resource-group]
[--sample-input-dataset-id]
[--sample-output-dataset-id]
[--subscription-id]
[--workspace-name]
[-v]
必需参数
模型的 ID。
可选参数
要添加的键/值属性(e.g. key=value )。 可以使用多个 --add-property 选项指定多个属性。
要添加的键/值标记(e.g. key=value )。 可以使用多个 --add-tag 选项指定多个标记。
要为此模型分配的默认 CPU 核心数。 可以是小数。
更新模型的说明。 将替换当前说明。
要为此模型分配的默认内存量(以 GB 为单位)。 可以是小数。
要为此模型分配的默认 GPU 数。
项目文件夹的路径。 默认值:当前目录。
要删除的标记键。 可以使用多个 --remove-tag 选项指定多个标记。
与提供的工作区对应的资源组。
示例输入数据集的 ID。
示例输出数据集的 ID。
指定订阅 ID。
工作区的名称。
详细标志。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。