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

az ml component

注意

此参考是 Azure CLI (2.15.0 或更高版本) 的 ml 扩展的一部分。 首次运行 az ml component 命令时,扩展会自动安装。 详细了解扩展。

管理 Azure ML 组件。

Azure ML 组件定义管道作业的组件配置。 可以配置组件的输入/输出端口、执行环境和命令。 创建组件后,可以引用管道作业中的组件,以在 docker 容器中执行它们。

命令

az ml component archive

存档组件。

az ml component create

创建组件。

az ml component list

列出工作区中的组件。

az ml component restore

还原存档组件。

az ml component show

显示组件的详细信息。

az ml component update

更新组件。 目前只有几个字段 (说明,display_name) 支持更新。

az ml component archive

存档组件。

默认情况下,存档组件会在列表查询 () az ml component list 隐藏它。 你仍然可以在管道中继续引用和使用存档组件。 可以存档组件容器或特定组件版本。 存档组件容器将存档该给定名称下组件的所有版本。 You can restore an archived component using az ml component restore. 如果存档了整个组件容器,则无法还原组件的单个版本 - 需要还原组件容器。

az ml component archive --name
                        --resource-group
                        --workspace-name
                        [--label]
                        [--version]

示例

存档组件容器 (存档该组件的所有版本)

az ml component archive --name my-component --resource-group my-resource-group --workspace-name my-workspace

存档特定组件版本

az ml component archive --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

必需参数

--name -n

组件的名称。

--resource-group -g

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

--workspace-name -w

Azure ML 工作区的名称。 可以使用 az configure --defaults workspace=<name> 配置默认组。

可选参数

--label -l

组件的标签。

--version -v

组件的版本。

az ml component create

创建组件。

az ml component create --file
                       [--name]
                       [--registry-name]
                       [--resource-group]
                       [--set]
                       [--skip-validation]
                       [--version]
                       [--workspace-name]

示例

从 YAML 规范文件创建组件

az ml component create --file my_component.yml --resource-group my-resource-group --workspace-name my-workspace

从具有指定版本的 YAML 规范文件创建组件

az ml component create --file my_component.yml --version 1 --resource-group my-resource-group --workspace-name my-workspace

从 YAML 规范文件在注册表中创建组件

az ml component create --file my_component.yml --registry-name my-registry-name --resource-group my-resource-group

从具有指定版本的 YAML 规范文件在注册表中创建组件

az ml component create --file my_component.yml --version 1 --registry-name my-registry-name --resource-group my-resource-group

必需参数

--file -f

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

可选参数

--name -n

组件的名称。

--registry-name

如果提供,该命令将面向注册表而不是工作区。 因此,不需要资源组和工作区。

--resource-group -g

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

--set

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

--skip-validation

跳过创建资源的验证。 请注意,依赖资源不会跳过其创建中的验证。

--version -v

组件的版本。

--workspace-name -w

Azure ML 工作区的名称。 可以使用 az configure --defaults workspace=<name> 配置默认组。

az ml component list

列出工作区中的组件。

az ml component list [--archived-only]
                     [--include-archived]
                     [--max-results]
                     [--name]
                     [--registry-name]
                     [--resource-group]
                     [--workspace-name]

示例

列出工作区中的所有组件

az ml component list --resource-group my-resource-group --workspace-name my-workspace

列出工作区中指定名称的所有组件版本

az ml component list --name my-component --resource-group my-resource-group --workspace-name my-workspace

使用 --query 参数列出工作区中的所有组件,以对命令结果执行 JMESPath 查询。

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

列出注册表中的所有组件

az ml component list --registry-name my-registry-name --resource-group my-resource-group

列出注册表中指定名称的所有组件版本

az ml component list --name my-component --registry-name my-registry-name --resource-group my-resource-group

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

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

可选参数

--archived-only

仅列出存档的组件。

--include-archived

列出存档的组件和活动组件。

--max-results -r

要返回的最大结果数。

--name -n

组件的名称。

--registry-name

如果提供,该命令将面向注册表而不是工作区。 因此,不需要资源组和工作区。

--resource-group -g

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

--workspace-name -w

Azure ML 工作区的名称。 可以使用 az configure --defaults workspace=<name> 配置默认组。

az ml component restore

还原存档组件。

还原存档组件后,它将不再从列表查询 (az ml component list) 隐藏。 如果存档了整个组件容器,则可以还原该已存档容器。 这将还原该给定名称下组件的所有版本。 如果存档整个组件容器,则不能仅还原特定的组件版本 - 需要还原整个容器。 如果仅存档单个组件版本,则可以还原该特定版本。

az ml component restore --name
                        --resource-group
                        --workspace-name
                        [--label]
                        [--version]

示例

还原存档组件容器 (还原该组件的所有版本)

az ml component restore --name my-component --resource-group my-resource-group --workspace-name my-workspace

还原特定的存档组件版本

az ml component restore --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

必需参数

--name -n

组件的名称。

--resource-group -g

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

--workspace-name -w

Azure ML 工作区的名称。 可以使用 az configure --defaults workspace=<name> 配置默认组。

可选参数

--label -l

组件的标签。

--version -v

组件的版本。

az ml component show

显示组件的详细信息。

az ml component show --name
                     [--label]
                     [--registry-name]
                     [--resource-group]
                     [--version]
                     [--workspace-name]

示例

显示具有指定名称和版本的组件的详细信息

az ml component show --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

显示注册表中具有指定名称和版本组件的详细信息

az ml component show --name my-component --version 1 --registry-name my-registry-name --resource-group my-resource-group

必需参数

--name -n

组件的名称。

可选参数

--label -l

组件的标签。

--registry-name

如果提供,该命令将面向注册表而不是工作区。 因此,不需要资源组和工作区。

--resource-group -g

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

--version -v

组件的版本。

--workspace-name -w

Azure ML 工作区的名称。 可以使用 az configure --defaults workspace=<name> 配置默认组。

az ml component update

更新组件。 目前只有几个字段 (说明,display_name) 支持更新。

az ml component update --name
                       --resource-group
                       --workspace-name
                       [--add]
                       [--force-string]
                       [--label]
                       [--remove]
                       [--set]
                       [--version]

示例

更新组件的说明

az ml component update -n my_component -v 1 --set description="new description" -g my-resource-group -w my-workspace

必需参数

--name -n

组件的名称。

--resource-group -g

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

--workspace-name -w

Azure ML 工作区的名称。 可以使用 az configure --defaults workspace=<name> 配置默认组。

可选参数

--add

通过指定路径和键值对将对象添加到对象列表。 示例:--add property.listProperty <key=value、string 或 JSON 字符串>。

--force-string

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

--label -l

组件的标签。

--remove

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

--set

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

--version -v

组件的版本。