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

az ml service

参考

注意

此参考是 Azure CLI（版本 2.0.28 或更高版本）的 azure-cli-ml 扩展的一部分。该扩展将在首次运行 az ml service 命令时自动安装。详细了解扩展。

管理操作化服务。

命令

名称	说明	类型	状态
az ml service delete	从工作区中删除服务。	扩展	GA
az ml service get-access-token	获取用于颁发服务请求的令牌。	扩展	GA
az ml service get-keys	获取针对服务发出请求的密钥。	扩展	GA
az ml service get-logs	获取服务的日志。	扩展	GA
az ml service list	列出工作区中的服务。	扩展	GA
az ml service regen-key	重新生成服务的密钥。	扩展	GA
az ml service run	在工作区中运行服务。	扩展	GA
az ml service show	显示工作区中服务的详细信息。	扩展	GA
az ml service update	更新工作区中的服务。	扩展	GA

az ml service delete

从工作区中删除服务。

az ml service delete --name
                     [--path]
                     [--resource-group]
                     [--subscription-id]
                     [--workspace-name]
                     [-v]

必需参数

--name -n

要删除的服务名称。

可选参数

--path

项目文件夹的路径。默认值：当前目录。

--resource-group -g

与提供的工作区对应的资源组。

--subscription-id

指定订阅 ID。

--workspace-name -w

包含要删除的服务的工作区的名称。

-v

详细标志。

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az ml service get-access-token

获取用于颁发服务请求的令牌。

az ml service get-access-token --name
                               [--path]
                               [--resource-group]
                               [--subscription-id]
                               [--workspace-name]
                               [-v]

必需参数

--name -n

服务名称。

可选参数

--path

项目文件夹的路径。默认值：当前目录。

--resource-group -g

与提供的工作区对应的资源组。

--subscription-id

指定订阅 ID。

--workspace-name -w

包含要显示的服务的工作区的名称。

-v

详细标志。

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az ml service get-keys

获取针对服务发出请求的密钥。

az ml service get-keys --name
                       [--path]
                       [--resource-group]
                       [--subscription-id]
                       [--workspace-name]
                       [-v]

必需参数

--name -n

服务名称。

可选参数

--path

项目文件夹的路径。默认值：当前目录。

--resource-group -g

与提供的工作区对应的资源组。

--subscription-id

指定订阅 ID。

--workspace-name -w

包含要显示的服务的工作区的名称。

-v

详细标志。

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az ml service get-logs

获取服务的日志。

az ml service get-logs --name
                       [--init]
                       [--num_lines]
                       [--path]
                       [--resource-group]
                       [--subscription-id]
                       [--workspace-name]
                       [-v]

必需参数

--name -n

服务名称。

可选参数

--init -i

获取 init 容器的日志，而不是评分容器。

默认值: False

--num_lines -l

要从结尾返回的日志行数（默认值为 5000）。

默认值: 5000

--path

项目文件夹的路径。默认值：当前目录。

--resource-group -g

与提供的工作区对应的资源组。

--subscription-id

指定订阅 ID。

--workspace-name -w

包含要显示的服务的工作区的名称。

-v

详细标志。

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az ml service list

列出工作区中的服务。

az ml service list [--compute-type]
                   [--image-digest]
                   [--model-id]
                   [--model-name]
                   [--path]
                   [--property]
                   [--resource-group]
                   [--subscription-id]
                   [--tag]
                   [--workspace-name]
                   [-v]

可选参数

--compute-type -c

如果提供，将仅显示具有指定计算类型的服务。（选项为“ACI”、“AKS”）。

--image-digest

如果提供，将仅显示具有指定图像摘要的服务。

--model-id

如果提供，将仅显示具有指定模型 ID 的服务。

--model-name

如果提供，将仅显示具有指定模型名称的服务。

--path

项目文件夹的路径。默认值：当前目录。

--property

如果提供，将根据提供的键/值（e.g. key或 key=value）进行筛选。可以使用多个 --property 选项指定多个属性。

默认值: []

--resource-group -g

与提供的工作区对应的资源组。

--subscription-id

指定订阅 ID。

--tag

如果提供，将根据提供的键/值（e.g. key或 key=value）进行筛选。可以使用多个 --tag 选项指定多个标记。

默认值: []

--workspace-name -w

包含要列出的服务的工作区的名称。

-v

详细标志。

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az ml service regen-key

重新生成服务的密钥。

az ml service regen-key --key
                        --name
                        [--path]
                        [--resource-group]
                        [--set-key]
                        [--subscription-id]
                        [--workspace-name]
                        [-v]

必需参数

--key -k

如果指定了 regen，则重新生成哪个密钥。选项：主数据库、辅助数据库。

--name -n

服务名称。

可选参数

--path

项目文件夹的路径。默认值：当前目录。

--resource-group -g

与提供的工作区对应的资源组。

--set-key -s

为指定的密钥提供身份验证值。

--subscription-id

指定订阅 ID。

--workspace-name -w

包含要显示的服务的工作区的名称。

-v

详细标志。

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az ml service run

在工作区中运行服务。

az ml service run --name
                  [--input-data]
                  [--path]
                  [--resource-group]
                  [--subscription-id]
                  [--workspace-name]
                  [-v]

必需参数

--name -n

要对其评分的服务名称。

可选参数

--input-data -d

用于调用 Web 服务的数据。

--path

项目文件夹的路径。默认值：当前目录。

--resource-group -g

与提供的工作区对应的资源组。

--subscription-id

指定订阅 ID。

--workspace-name -w

包含要运行的服务的工作区的名称。

-v

详细标志。

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az ml service show

显示工作区中服务的详细信息。

az ml service show --name
                   [--path]
                   [--resource-group]
                   [--subscription-id]
                   [--workspace-name]
                   [-v]

必需参数

--name -n

要显示的 Web 服务的名称。

可选参数

--path

项目文件夹的路径。默认值：当前目录。

--resource-group -g

与提供的工作区对应的资源组。

--subscription-id

指定订阅 ID。

--workspace-name -w

包含要显示的服务的工作区的名称。

-v

详细标志。

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

az ml service update

更新工作区中的服务。

az ml service update --name
                     [--add-property]
                     [--add-tag]
                     [--ae]
                     [--ai]
                     [--ar]
                     [--as]
                     [--at]
                     [--autoscale-max-replicas]
                     [--autoscale-min-replicas]
                     [--base-image]
                     [--base-image-registry]
                     [--cc]
                     [--ccl]
                     [--cf]
                     [--collect-model-data]
                     [--compute-target]
                     [--cuda-version]
                     [--dc]
                     [--description]
                     [--dn]
                     [--ds]
                     [--ed]
                     [--eg]
                     [--entry-script]
                     [--environment-name]
                     [--environment-version]
                     [--failure-threshold]
                     [--gb]
                     [--gbl]
                     [--gc]
                     [--ic]
                     [--id]
                     [--is-migration]
                     [--kp]
                     [--ks]
                     [--lo]
                     [--max-request-wait-time]
                     [--model]
                     [--model-metadata-file]
                     [--no-wait]
                     [--nr]
                     [--path]
                     [--period-seconds]
                     [--po]
                     [--remove-tag]
                     [--replica-max-concurrent-requests]
                     [--resource-group]
                     [--rt]
                     [--sc]
                     [--scoring-timeout-ms]
                     [--sd]
                     [--se]
                     [--sk]
                     [--sp]
                     [--st]
                     [--subscription-id]
                     [--timeout-seconds]
                     [--token-auth-enabled]
                     [--workspace-name]
                     [-v]

必需参数

--name -n

要更新的服务名称。

可选参数

--add-property

要添加的键/值属性（e.g. key=value ）。可以使用多个 --add-property 选项指定多个属性。

默认值: []

--add-tag

要添加的键/值标记（e.g. key=value ）。可以使用多个 --add-tag 选项指定多个标记。

默认值: []

--ae --auth-enabled

是否为此 Webservice 启用密钥身份验证。默认为 False。

--ai --enable-app-insights

是否为此 Webservice 启用 AppInsights。默认为 False。

--ar --autoscale-refresh-seconds

自动缩放程序应尝试缩放此 Webservice 的频率。默认值为 1。

--as --autoscale-enabled

是否为此 Web 服务启用自动缩放。如果 num_replicas 为 None，则默认值为 True。

--at --autoscale-target-utilization

自动缩放程序应尝试维持此 Web 服务的目标利用率（低于 100%）。默认值为 70。

--autoscale-max-replicas --ma

自动缩放此 Webservice 时要使用的容器的最大数目。默认值为 10。

--autoscale-min-replicas --mi

自动缩放此 Webservice 时要使用的容器的最小数目。默认值为 1。

--base-image --bi

用作基础映像的自定义映像。如果未提供基础映像，则基于给定的运行时参数使用基础映像。

--base-image-registry --ir

包含基础映像的映像注册表。

--cc --cpu-cores

要分配给此 Webservice 的 CPU 核心数。可以是小数。默认值为 0.1。

--ccl --cpu-cores-limit

允许此 Web 服务使用的最大 CPU 核心数。可以是小数。

--cf --conda-file

包含要用于映像的 conda 环境定义的本地文件的路径。

--collect-model-data --md

是否为此 Web 服务启用模型数据收集。默认为 False。

--compute-target

（预览版）指定安装了 AzureML 扩展以托管已迁移的 Kubernetes 联机终结点和部署的计算目标。

--cuda-version --cv

要为需要 GPU 支持的映像安装 CUDA 版本。 GPU 映像必须用于 Azure 容器实例、Azure 机器学习计算、Azure 虚拟机和 Azure Kubernetes 服务等 Microsoft Azure 服务。支持的版本为 9.0、9.1 和 10.0。如果设置了“enable_gpu”，则默认值为“9.1”。

--dc --deploy-config-file

包含部署元数据的 JSON 文件的路径。

--description -d

服务说明。

--dn --dns-name-label

此 Web 服务的 dns 名称。

--ds --extra-docker-file-steps

本地文件的路径，其中包含设置映像时要运行的其他 Docker 步骤。

--ed --environment-directory

用于部署Azure 机器学习环境的目录。它与“az ml environment scaffold”命令中提供的目录路径相同。

--eg --enable-gpu

是否在映像中启用 GPU 支持。 GPU 映像必须用于 Azure 容器实例、Azure 机器学习计算、Azure 虚拟机和 Azure Kubernetes 服务等 Microsoft Azure 服务。默认为 False。

--entry-script --es

包含要为服务运行的代码的本地文件的路径（如果提供了source_directory的相对路径）。

--environment-name -e

用于部署Azure 机器学习环境的名称。

--environment-version --ev

用于部署的现有Azure 机器学习环境的版本。

--failure-threshold --ft

当 Pod 启动且运行情况探测失败时，Kubernetes 会在放弃之前尝试 --failure-threshold times。默认值为 3。最小值为 1。

--gb --memory-gb

为此 Webservice 分配的内存量 (GB)。可以是小数。

--gbl --memory-gb-limit

允许此 Web 服务使用的最大内存量 (GB)。可以是小数。

--gc --gpu-cores

要为此 Web 服务分配的 gpu 核心数。默认值为 1。

--ic --inference-config-file

包含推理配置的 JSON 或 YAML 文件的路径。

--id --initial-delay-seconds

启动容器后，启动运行情况探测前的秒数。默认值为 310。

--is-migration

（预览版）是否将 AKS Web 服务迁移到 Kubernetes 联机终结点和部署。默认为 False。

--kp --primary-key

要用于此 Webservice 的主要身份验证密钥。

--ks --secondary-key

要用于此 Webservice 的辅助身份验证密钥。

--lo --location

要将此 Webservice 部署到的 Azure 区域。如果未指定，将使用工作区位置。有关可用区域的更多详细信息，可在此处找到： https://azure.microsoft.com/en-us/global-infrastructure/services/?regions=all&products=container-instances。

--max-request-wait-time --mr

在返回 503 错误之前，请求将在队列中停留的最长时间（以毫秒为单位）。默认为 500。

--model -m

要部署的模型的 ID。可以使用其他 -m 参数指定多个模型。模型需要首先注册。

默认值: []

--model-metadata-file -f

包含模型注册元数据的 JSON 文件的路径。可以使用多个 -f 参数提供多个模型。

默认值: []

--no-wait

标志不等待异步调用。

--nr --num-replicas

要分配给此 Webservice 的容器数量。无默认值，如果未设置此参数，则默认启用自动缩放程序。

--path

项目文件夹的路径。默认值：当前目录。

--period-seconds --ps

执行运行情况探测的频率（秒）。默认值为 10 秒。最小值为 1。

--po --port

用于公开服务的 HTTP 终结点的本地端口。

--remove-tag

要删除的标记键。可以使用多个 --remove-tag 选项指定多个标记。

默认值: []

--replica-max-concurrent-requests --rm

允许此 Web 服务的每个节点的最大并发请求数。默认值为 1。

--resource-group -g

与提供的工作区对应的资源组。

--rt --runtime

要用于映像的运行时。当前支持的运行时为“spark-py”和“python”spark-py|python|python-slim。

--sc --ssl-cname

启用 SSL 时的 cname。仅在更新 ACI 服务时适用。

--scoring-timeout-ms --tm

对此 Webservice 的评分调用强制执行的超时时间。默认值为 60000。

--sd --source-directory

包含要创建映像的所有文件的文件夹的路径。

--se --ssl-enabled

是否为此 Webservice 启用 SSL。默认为 False。

--sk --ssl-key-pem-file

如果启用了 SSL，则需要密钥文件。

--sp --ssl-cert-pem-file

如果启用了 SSL，则需要证书文件。

--st --success-threshold

运行情况探测失败后，将其视为成功所需的最小连续成功次数。默认值为 1。最小值为 1。

--subscription-id

指定订阅 ID。

--timeout-seconds --ts

运行情况探测超时前等待的秒数。默认值为 2 秒。最小值为 1。

--token-auth-enabled

是否为此 Web 服务启用令牌身份验证。仅适用于 AKS Web 服务。默认为 False。

--workspace-name -w

包含要更新的服务的工作区的名称。

-v

详细标志。

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

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

--subscription

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

--verbose

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

通过

az ml service

命令

az ml service delete

必需参数

可选参数

az ml service get-access-token

必需参数

可选参数

az ml service get-keys

必需参数

可选参数

az ml service get-logs

必需参数

可选参数

az ml service list

可选参数

az ml service regen-key

必需参数

可选参数

az ml service run

必需参数

可选参数

az ml service show

必需参数

可选参数

az ml service update

必需参数

可选参数

其他资源