az ml registry

  • 參考

注意

此參考是 Azure CLI 的 ml 延伸模組的一部分（2.15.0 版或更高版本）。 擴充功能會在您第一次執行 az ml registry 命令時自動安裝。 深入了解擴充功能。

管理 Azure ML 登錄。

Azure ML 登錄是 Azure 機器學習 的最上層資源。 它提供最上層空間來儲存其他資源，然後可由跨不同區域的多個工作區存取。

命令

名稱 Description 類型 狀態
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 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

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ml registry list

列出訂用帳戶或資源群組中的所有登錄。

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

範例

列出預設資源群組和訂用帳戶標識碼中的所有登錄。

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

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ml registry update

更新登錄。

更新登錄。 此命令的行為大多與 create 命令類似，不同之處在於這可確保目標登錄存在，而且如果提供有效的 --name 輸入，則可以在沒有 --file 輸入的情況下執行。 您可以在 YAML、--set 自變數或欄位的一般輸入自變數中定義新值來修改欄位。 並非所有欄位目前都安全修改。 有效的修改包括：登錄標籤的任意變更，並將新值新增至 [region_details] 字段。 警告：--file 自變數與透過 --set 修改值不相容。 如果您想要使用檔案和 CLI args 的組合來設定登錄，請使用直接 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> 或 --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

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。