az ml component

Note

このリファレンスは、Azure CLI (バージョン 2.15.0 以降) の ml 拡張機能の一部です。 拡張機能は、az ml component コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細をご覧ください。

Azure ML コンポーネントを管理します。

Azure ML コンポーネントは、パイプライン ジョブのコンポーネントの構成を定義します。 入力/出力ポート、実行環境、およびコンポーネントのコマンドを構成できます。 コンポーネントが作成されたら、パイプライン ジョブ内のコンポーネントを参照して、Docker コンテナーで実行できます。

コマンド

名前	説明	型	Status
az ml component archive	コンポーネントをアーカイブします。	拡張子	GA
az ml component create	コンポーネントを作成する。	拡張子	GA
az ml component list	ワークスペース内のコンポーネントを一覧表示します。	拡張子	GA
az ml component restore	アーカイブされたコンポーネントを復元します。	拡張子	GA
az ml component show	コンポーネントの詳細を表示します。	拡張子	GA
az ml component update	コンポーネントを更新します。 現在、更新プログラムをサポートするフィールド (説明、display_name) はごくわずかです。	拡張子	GA

az ml component archive

コンポーネントをアーカイブします。

コンポーネントをアーカイブすると、既定ではリスト クエリ (az ml component list) から非表示になります。 引き続きパイプラインでアーカイブされたコンポーネントを参照して使用できます。 コンポーネント コンテナーまたは特定のコンポーネント バージョンをアーカイブできます。 コンポーネント コンテナーをアーカイブすると、その名前の下にあるコンポーネントのすべてのバージョンがアーカイブされます。 アーカイブされたコンポーネントを復元するには、次を使用します az ml component restore。 コンポーネント コンテナー全体がアーカイブされている場合、コンポーネントの個々のバージョンを復元することはできません。コンポーネント コンテナーを復元する必要があります。

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

例

コンポーネント コンテナーをアーカイブする (そのコンポーネントのすべてのバージョンをアーカイブする)

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

コンポーネント名。

省略可能のパラメーター

--label -l

コンポーネントのラベル。

--registry-name

指定した場合、コマンドはワークスペースではなくレジストリを対象とします。 そのため、リソース グループとワークスペースは必要ありません。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--version -v

コンポーネントのバージョン。

--workspace-name -w

Azure ML ワークスペースの名前。 を使用して、既定のワークスペースを az configure --defaults workspace=<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 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

リソースの作成で検証をスキップします。 依存リソースは、作成時に検証をスキップしないことに注意してください。

既定値: False

--version -v

コンポーネントのバージョン。

--workspace-name -w

Azure ML ワークスペースの名前。 を使用して、既定のワークスペースを az configure --defaults workspace=<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 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

アーカイブされたコンポーネントのみを一覧表示します。

既定値: False

--include-archived

アーカイブされたコンポーネントとアクティブなコンポーネントを一覧表示します。

既定値: False

--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>構成できます。

グローバル パラメーター

--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 component restore

アーカイブされたコンポーネントを復元します。

アーカイブされたコンポーネントが復元されると、リスト クエリ (az ml component list) では非表示ではなくなります。 コンポーネント コンテナー全体がアーカイブされている場合は、そのアーカイブされたコンテナーを復元できます。 これにより、指定された名前のコンポーネントのすべてのバージョンが復元されます。 コンポーネント コンテナー全体がアーカイブされている場合、特定のコンポーネント バージョンのみを復元することはできません。コンテナー全体を復元する必要があります。 個々のコンポーネント バージョンのみがアーカイブされた場合は、その特定のバージョンを復元できます。

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

例

アーカイブされたコンポーネント コンテナーを復元する (そのコンポーネントのすべてのバージョンを復元します)

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

コンポーネント名。

省略可能のパラメーター

--label -l

コンポーネントのラベル。

--registry-name

指定した場合、コマンドはワークスペースではなくレジストリを対象とします。 そのため、リソース グループとワークスペースは必要ありません。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--version -v

コンポーネントのバージョン。

--workspace-name -w

Azure ML ワークスペースの名前。 を使用して、既定のワークスペースを az configure --defaults workspace=<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 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>構成できます。

グローバル パラメーター

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

コンポーネントを更新します。 現在、更新プログラムをサポートするフィールド (説明、display_name) はごくわずかです。

az ml component update --name
                       --resource-group
                       --workspace-name
                       [--add]
                       [--force-string]
                       [--label]
                       [--registry-name]
                       [--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 or JSON string>。

既定値: []

--force-string

'set' または 'add' を使用する場合は、JSON に変換するのではなく、文字列リテラルを保持します。

既定値: False

--label -l

コンポーネントのラベル。

--registry-name

指定した場合、コマンドはワークスペースではなくレジストリを対象とします。 そのため、リソース グループとワークスペースは必要ありません。

--remove

リストからプロパティまたは要素を削除します。 例: --remove property.list <indexToRemove> OR --remove propertyToRemove.

既定値: []

--set

設定するプロパティ パスと値を指定して、オブジェクトを更新します。 例: --set property1.property2=<value>。

既定値: []

--version -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 を使います。