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 來取得完整偵錯記錄。