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

az ml registry

参考

注意

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

管理 Azure ML 注册表。

Azure ML 注册表是用于Azure 机器学习的顶级资源。它提供了一个顶级空间来存储其他资源，然后可以通过跨不同区域的多个工作区访问这些资源。

命令

名称	说明	类型	Status
az ml registry create	创建注册表。	扩展	GA
az ml registry delete	删除给定的注册表。	扩展	GA
az ml registry list	列出订阅或资源组中的所有注册表。	扩展	GA
az ml registry show	显示注册表的详细信息。	扩展	GA
az ml registry update	更新注册表。	扩展	GA

az ml registry create

创建注册表。

创建注册表时，默认情况下，注册表将使用的多个 Azure 资源，特别是Azure 存储和Azure 容器注册表。不支持在创建注册表时为这些实例使用现有的 Azure 资源实例。

az ml registry create --resource-group
                      [--display-name]
                      [--file]
                      [--name]
                      [--no-wait]
                      [--public-network-access]
                      [--set]
                      [--tags]

示例

从 YAML 规范文件创建注册表。

az ml registry create --resource-group my-resource-group --file registry.yml

必需参数

--resource-group -g

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

可选参数

--display-name

注册表的显示名称。

--file -f

包含 Azure ML 注册表规范的 YAML 文件的本地路径。可以在以下位置找到注册表的 YAML 参考文档。 https://aka.ms/ml-cli-v2-registry-yaml-reference

--name -n

Azure ML 注册表的名称。

--no-wait

不要等待注册表创建完成。

默认值: False

--public-network-access

允许注册表的公共终结点连接。

--set

通过指定要设置的属性路径和值来更新对象。示例：--set property1.property2=。

--tags

对象的标记的空间分隔键值对。

全局参数

--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 registry delete

删除给定的注册表。

az ml registry delete [--name]
                      [--resource-group]

示例

从特定资源组中删除注册表。

az ml registry delete --resource-group my-resource-group --name my-registry-name

可选参数

--name -n

Azure ML 注册表的名称。可以使用 az configure --defaults registry=<name> 配置默认组。

--resource-group -g

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

全局参数

--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 registry list

列出订阅或资源组中的所有注册表。

az ml registry list [--max-results]
                    [--resource-group]

示例

列出默认资源组和订阅 ID 中的所有注册表。

az ml registry list

列出指定订阅中默认资源组中的所有注册表。如果未设置默认资源组，则列出订阅中的所有注册表。

az ml registry list --subscription my-subscription-id

列出特定资源组和订阅中的所有注册表。

az ml registry list --resource-group my-resource-group --subscription my-subscription-id

列出所有使用 --query 参数对命令结果执行 JMESPath 查询的注册表。

az ml registry list --query "[].{Name:name}"  --output table --resource-group my-resource-group

可选参数

--max-results -r

要返回的最大结果数。

--resource-group -g

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

全局参数

--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 registry show

显示注册表的详细信息。

az ml registry show --name
                    --resource-group

示例

显示指定资源组和订阅中命名注册表的详细信息。

az ml registry show --resource-group my-resource-group --subscription my-subscription-id --name my-registry-name

必需参数

--name -n

Azure ML 注册表的名称。可以使用 az configure --defaults registry=<name> 配置默认组。

--resource-group -g

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

全局参数

--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 registry update

更新注册表。

更新注册表。此命令的行为主要类似于 create 命令，但这是确保目标注册表存在，并且如果提供了有效的 --name 输入，则可以在没有 --file 输入的情况下运行它。可以通过在 YAML、-set 参数或字段的普通输入参数中定义新值来修改字段。并非所有字段当前都安全修改。有效的修改包括：对注册表标记的任意更改，并将新值添加到region_details字段。警告：--file 参数与通过 --set 修改值不兼容。如果要使用文件和 CLI 参数的组合设置注册表，请使用直接 CLI 参数来修改要修改的值，如下所示。

az ml registry update --resource-group
                      [--add]
                      [--display-name]
                      [--file]
                      [--force-string]
                      [--name]
                      [--no-wait]
                      [--public-network-access]
                      [--remove]
                      [--set]
                      [--tags]

示例

从 YAML 规范文件更新注册表。

az ml registry update --resource-group my-resource-group --file registry.yml --tags tag=value

更新注册表的特定字段

az ml registry update --resource-group my-resource-group --name myRegistry --set tags.tag=value

必需参数

--resource-group -g

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

可选参数

--add

通过指定路径和键值对将对象添加到对象列表。示例：--add property.listProperty <key=value, string or JSON string>。

默认值: []

--display-name

注册表的显示名称。

--file -f

包含 Azure ML 注册表规范的 YAML 文件的本地路径。可以在以下位置找到注册表的 YAML 参考文档。 https://aka.ms/ml-cli-v2-registry-yaml-reference

--force-string

使用“set”或“add”时，保留字符串文本，而不是尝试转换为 JSON。

默认值: False

--name -n

Azure ML 注册表的名称。

--no-wait

不要等待注册表更新完成。

默认值: False

--public-network-access

允许注册表的公共终结点连接。

--remove

从列表中删除属性或元素。示例： --remove property.list <indexToRemove> OR --remove propertyToRemove.

默认值: []

--set

通过指定要设置的属性路径和值来更新对象。示例：--set property1.property2=<value>。

默认值: []

--tags

对象的标记的空间分隔键值对。

全局参数

--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 获取完整的调试日志。