Share via

az ml registry

  • リファレンス

Note

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

Azure ML レジストリを管理します。

Azure ML レジストリは、Azure Machine ラーニングの最上位レベルのリソースです。 他のリソースを格納するための最上位レベルの領域が提供され、異なるリージョン間で複数のワークスペースからアクセスできます。

コマンド

名前 説明 型 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 Storage と Azure Container Registry です。 レジストリ作成時の既存の 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 を使います。