az ml registry

Note

This reference is part of the ml extension for the Azure CLI (version 2.15.0 or higher). 當您第一次執行 az ml registry 命令時，擴充功能會自動安裝。 Learn more about extensions.

管理 Azure ML 登錄。

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

命令

名稱	Description	類型	狀態
az ml registry create	建立登錄。	Extension	GA
az ml registry delete	刪除指定的登錄。	Extension	GA
az ml registry list	列出訂用帳戶或資源群組中的所有登錄。	Extension	GA
az ml registry show	顯示登錄的詳細數據。	Extension	GA
az ml registry update	更新登錄。	Extension	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>來設定預設群組。

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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=value。

--tags

對象標記的空間分隔索引鍵/值組。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az ml registry delete

刪除指定的登錄。

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

範例

從特定資源群組刪除登錄。

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

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--name -n

Azure ML 登錄的名稱。 您可以使用 az configure --defaults registry=<name>來設定預設群組。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--max-results -r

要傳回的結果數目上限。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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>來設定預設群組。

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--add

藉由指定路徑和索引鍵值組，將物件加入物件清單。 範例： --add property.listProperty <key=value, string or JSON string>.

屬性	值
Parameter group:	Generic Update Arguments
預設值:	[]

--display-name

登錄的顯示名稱。

--file -f

包含 Azure ML 登錄規格之 YAML 檔案的本機路徑。 登入的 YAML 參考檔案位於：https://aka.ms/ml-cli-v2-registry-yaml-reference。

--force-string

使用 'set' 或 'add' 時，請保留字串常值，而不是嘗試轉換成 JSON。

屬性	值
Parameter group:	Generic Update Arguments
預設值:	False

--name -n

Azure ML 登錄的名稱。

--no-wait

請勿等候登錄更新完成。

屬性	值
預設值:	False

--public-network-access

允許登錄的公用端點連線。

--remove

從清單中移除屬性或專案。 範例： --remove property.list <indexToRemove> 或 --remove propertyToRemove。

屬性	值
Parameter group:	Generic Update Arguments
預設值:	[]

--set

指定要設定的屬性路徑和值，以更新物件。 範例： --set property1.property2=<value>.

屬性	值
Parameter group:	Generic Update Arguments
預設值:	[]

--tags

對象標記的空間分隔索引鍵/值組。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False