az ml batch-deployment

參考

注意

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

管理 Azure ML 批次部署。

Azure ML 部署提供簡單的介面來建立和管理模型部署。

命令

名稱	Description	類型	狀態
az ml batch-deployment create	建立部署。如果部署已經存在，則會以新的設定過度寫入。	副檔名	GA
az ml batch-deployment delete	刪除部署。	副檔名	GA
az ml batch-deployment list	列出部署。	副檔名	GA
az ml batch-deployment list-jobs	列出批次部署的批次評分作業。	副檔名	GA
az ml batch-deployment show	顯示部署。	副檔名	GA
az ml batch-deployment update	更新部署。	副檔名	GA

az ml batch-deployment create

建立部署。如果部署已經存在，則會以新的設定過度寫入。

az ml batch-deployment create --file
                              --resource-group
                              --workspace-name
                              [--endpoint-name]
                              [--name]
                              [--no-wait]
                              [--set]
                              [--set-default]
                              [--skip-script-validation]

範例

從 YAML 規格檔案建立部署

az ml batch-deployment create --file deployment.yaml --resource-group my-resource-group --workspace-name my-workspace

必要參數

--file -f

YAML 檔案的本機路徑，其中包含 Azure ML 批次部署規格。如需批次部署的 YAML 參考檔，請參閱： https://aka.ms/ml-cli-v2-deployment-batch-yaml-reference。

--resource-group -g

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

--workspace-name -w

Azure ML 工作區的名稱。您可以使用來設定預設工作區 az configure --defaults workspace=<name>。

選擇性參數

--endpoint-name -e

批次端點的名稱。

--name -n

部署的名稱。

--no-wait

請勿等候長時間執行的作業完成。預設值是 False。

預設值: False

--set

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

--set-default

在成功建立之後，將端點defaults.deployment_name設定為此部署，不適用於 --no-wait。

預設值: False

--skip-script-validation

允許使用者略過部署評分腳本驗證。

預設值: False

全域參數

--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 batch-deployment delete

刪除部署。

az ml batch-deployment delete --endpoint-name
                              --name
                              --resource-group
                              --workspace-name
                              [--no-wait]
                              [--yes]

範例

使用確認刪除部署

az ml batch-deployment delete --name my-deployment --endpoint-name my-endpoint --yes --resource-group my-resource-group --workspace-name my-workspace

必要參數

--endpoint-name -e

批次端點的名稱。

--name -n

部署的名稱。

--resource-group -g

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

--workspace-name -w

Azure ML 工作區的名稱。您可以使用來設定預設工作區 az configure --defaults workspace=<name>。

選擇性參數

--no-wait

請勿等候長時間執行的作業完成。預設值是 False。

預設值: False

--yes -y

不提示確認。

預設值: False

全域參數

--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 batch-deployment list

列出部署。

az ml batch-deployment list --endpoint-name
                            --resource-group
                            --workspace-name

範例

列出端點中的部署

az ml batch-deployment list --endpoint-name my-endpoint --resource-group my-resource-group --workspace-name my-workspace

必要參數

--endpoint-name -e

端點的名稱。

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

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

--verbose

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

az ml batch-deployment list-jobs

列出批次部署的批次評分作業。

az ml batch-deployment list-jobs --endpoint-name
                                 --name
                                 --resource-group
                                 --workspace-name

範例

列出特定部署的批次評分作業

az ml batch-deployment list-jobs --name my-batch-endpoint --endpoint-name my-endpoint --resource-group my-resource-group --workspace-name my-workspace

必要參數

--endpoint-name -e

批次端點的名稱。

--name -n

部署的名稱。

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

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

--verbose

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

az ml batch-deployment show

顯示部署。

az ml batch-deployment show --endpoint-name
                            --name
                            --resource-group
                            --workspace-name

範例

顯示部署

az ml batch-deployment show --name my-deployment --endpoint-name my-endpoint --resource-group my-resource-group --workspace-name my-workspace

必要參數

--endpoint-name -e

批次端點的名稱。

--name -n

部署的名稱。

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

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

--verbose

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

az ml batch-deployment update

更新部署。

az ml batch-deployment update --resource-group
                              --workspace-name
                              [--add]
                              [--endpoint-name]
                              [--file]
                              [--force-string]
                              [--name]
                              [--no-wait]
                              [--remove]
                              [--set]

範例

從 YAML 規格檔案更新部署

az ml batch-deployment update --file deployment.yaml --resource-group my-resource-group --workspace-name my-workspace

必要參數

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

預設值: []

--endpoint-name -e

批次端點的名稱。

--file -f

YAML 檔案的本機路徑，其中包含 Azure ML 批次部署規格。如需批次部署的 YAML 參考檔，請參閱： https://aka.ms/ml-cli-v2-deployment-batch-yaml-reference。

--force-string

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

預設值: False

--name -n

部署的名稱。

--no-wait

請勿等候長時間執行的作業完成。預設值是 False。

預設值: False

--remove

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

預設值: []

--set

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

預設值: []

全域參數

--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 batch-deployment

命令

az ml batch-deployment create

範例

必要參數

選擇性參數

az ml batch-deployment delete

範例

必要參數

選擇性參數

az ml batch-deployment list

範例

必要參數

az ml batch-deployment list-jobs

範例

必要參數

az ml batch-deployment show

範例

必要參數

az ml batch-deployment update

範例

必要參數

選擇性參數

其他資源