az ml compute
注意
此參考是 Azure CLI 的 ml 延伸模組的一部分(2.15.0 版或更高版本)。 擴充功能會在您第一次執行 az ml compute 命令時自動安裝。 深入了解擴充功能。
管理 Azure ML 計算資源。
Azure ML 計算目標是指定的計算資源,您可以在其中執行作業來定型或部署模型以進行推斷。
命令
名稱 | Description | 類型 | 狀態 |
---|---|---|---|
az ml compute attach |
將現有的計算資源附加至工作區。 |
副檔名 | GA |
az ml compute connect-ssh |
設定與計算實例的SSH連線。 |
副檔名 | 預覽 |
az ml compute create |
建立計算目標。 |
副檔名 | GA |
az ml compute delete |
刪除計算目標。 |
副檔名 | GA |
az ml compute detach |
中斷連結先前連結的計算資源與工作區。 |
副檔名 | GA |
az ml compute enable-sso |
在計算實例上啟用/停用單一登錄。 |
副檔名 | 預覽 |
az ml compute list |
列出工作區中的計算目標。 |
副檔名 | GA |
az ml compute list-nodes |
列出計算目標的節點詳細數據。 此命令唯一支援的計算類型是 AML 計算。 |
副檔名 | GA |
az ml compute list-sizes |
列出依位置可用的 VM 大小。 |
副檔名 | GA |
az ml compute list-usage |
列出 VM 的可用使用量資源。 |
副檔名 | GA |
az ml compute restart |
重新啟動 ComputeInstance 目標。 |
副檔名 | GA |
az ml compute show |
顯示計算目標的詳細數據。 |
副檔名 | GA |
az ml compute start |
啟動 ComputeInstance 目標。 |
副檔名 | GA |
az ml compute stop |
停止 ComputeInstance 目標。 |
副檔名 | GA |
az ml compute update |
更新計算目標。 |
副檔名 | GA |
az ml compute attach
將現有的計算資源附加至工作區。
Kubernetes 叢集和遠端 VM 可以連結為計算目標。
az ml compute attach --resource-group
--workspace-name
[--admin-password]
[--admin-username]
[--file]
[--identity-type]
[--name]
[--namespace]
[--no-wait]
[--resource-id]
[--ssh-port]
[--ssh-private-key-file]
[--type]
[--user-assigned-identities]
必要參數
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>
。
選擇性參數
可用來透過 SSH 連線到節點的系統管理員用戶密碼。
可用來透過 SSH 連線到節點的系統管理員用戶帳戶名稱。
包含 Azure ML 計算規格之 YAML 檔案的本機路徑。
受管理身分識別的類型。 允許的值:SystemAssigned、UserAssigned。
計算目標的名稱(如果未在 yaml 檔案中指定,則為必要專案)。
kubernetesCompute 的Namespace。
請勿等候長時間執行的作業完成。
資源的完整標識碼,包括資源名稱和資源類型(如果未在 yaml 檔案中指定則為必要)。
可用來透過 SSH 連線到節點的埠號碼。 如果未指定,則會使用預設的 (埠 22)。
包含系統管理員用戶帳戶 SSH 私鑰的檔案。
計算目標的型別。 允許的值:virtualmachine、Kubernetes。
--identity_type=UserAssigned 所需的使用者指派身分識別資源標識符。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az ml compute connect-ssh
此命令處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus
設定與計算實例的SSH連線。
az ml compute connect-ssh --name
--resource-group
--workspace-name
[--private-key-file-path]
範例
透過 SSH 連線到計算實例
az ml compute connect-ssh --name ci1 --resource-group my-resource-group --workspace-name my-workspace --private-key-file-path sshkey.pem
必要參數
計算目標的名稱。 必要。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>
。
選擇性參數
私鑰檔案的路徑。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az ml compute create
建立計算目標。
您可以建立 AmlCompute 叢集,這是 Azure ML 的受控計算基礎結構,或計算實例,這是受控雲端式工作站。
az ml compute create --resource-group
--workspace-name
[--admin-password]
[--admin-username]
[--description]
[--enable-node-public-ip]
[--file]
[--identity-type]
[--idle-time-before-scale-down]
[--location]
[--max-instances]
[--min-instances]
[--name]
[--no-wait]
[--set]
[--size]
[--ssh-key-value]
[--ssh-public-access-enabled]
[--subnet]
[--tags]
[--tier]
[--type]
[--user-assigned-identities]
[--user-object-id]
[--user-tenant-id]
[--vnet-name]
範例
從 YAML 規格檔案建立計算目標
az ml compute create --file compute.yml --resource-group my-resource-group --workspace-name my-workspace
使用命令選項建立 AmlCompute 目標
az ml compute create --name nc6-cluster --size Standard_NC6 --min-instances 0 --max-instances 5 --type AmlCompute --resource-group my-resource-group --workspace-name my-workspace
必要參數
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>
。
選擇性參數
如果驗證類型為 「密碼」,則為系統管理員用戶帳戶的密碼。
可用來透過 SSH 連線到節點的系統管理員用戶帳戶名稱。
計算目標的描述。
指出是否啟用公用IP。 預設值:True。
包含 Azure ML 計算規格之 YAML 檔案的本機路徑。 如需計算的 YAML 參考檔,請參閱: https://aka.ms/ml-cli-v2-compute-aml-yaml-reference、 https://aka.ms/ml-cli-v2-compute-instance-yaml-reference、 https://aka.ms/ml-cli-v2-compute-vm-yaml-reference。
受控識別的類型。 允許的值:SystemAssigned、UserAssigned。
在相應減少叢集之前,以秒為單位的節點空閒時間。 默認值:120。
計算的位置。 如果未指定,預設為工作區的位置。
叢集上要使用的節點數目上限。 默認值:4。
叢集上使用的節點數目下限。 預設:0。
計算目標的名稱。 如果未提供 --file/-f,則為必要專案。
請勿等候長時間執行的作業完成。 預設值是 False。
指定要設定的屬性路徑和值,以更新物件。 範例:--set property1.property2=。
要用於計算目標的 VM 大小。 如需詳細資訊,請參閱: https://aka.ms/azureml-vm-details。
系統管理員用戶帳戶的 SSH 公鑰。
指出是否啟用公用SSH埠。
子網路的名稱。 也可以依標識碼參考現有 vnet 中的子網,而不是名稱。 如果指定子網標識符,則會忽略 vnet-name。 子網標識碼可以指定完整子網標識符,以參考另一個 RG 中的 vnet/子網。 指定 vnet 名稱時為必要專案。
對象標記的空間分隔索引鍵/值組。
VM 優先順序層。 允許的值:專用、low_priority。
計算目標的型別。 如果未提供 --file/-f,則為必要專案。 允許的值:AmlCompute、ComputeInstance。
使用 '[system]' 來設定系統指派的身分識別,否則輸入資源標識符會以逗號 (ie ,) 分隔,以設定使用者指派的身分識別。
指派使用者的 AAD 物件識別碼。
指派使用者的 AAD 租使用者識別碼。
虛擬網路的名稱。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az ml compute delete
刪除計算目標。
az ml compute delete --name
--resource-group
--workspace-name
[--no-wait]
[--yes]
必要參數
計算目標的名稱(如果未在 yaml 檔案中指定,則為必要專案)。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>
。
選擇性參數
請勿等候長時間執行的作業完成。 預設值是 False。
不提示確認。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az ml compute detach
中斷連結先前連結的計算資源與工作區。
az ml compute detach --name
--resource-group
--workspace-name
[--no-wait]
[--yes]
必要參數
計算目標的名稱(如果未在 yaml 檔案中指定,則為必要專案)。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>
。
選擇性參數
請勿等候長時間執行的作業完成。
不提示確認。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az ml compute enable-sso
此命令處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus
在計算實例上啟用/停用單一登錄。
az ml compute enable-sso --name
--resource-group
--workspace-name
[--disable]
範例
啟用計算實例的單一登錄
az ml compute enable-sso --name ci1 --resource-group my-resource-group --workspace-name my-workspace
停用計算實例的單一登錄
az ml compute enable-sso --name ci1 --resource-group my-resource-group --workspace-name my-workspace --disable
必要參數
計算目標的名稱(如果未在 yaml 檔案中指定,則為必要專案)。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>
。
選擇性參數
停用單一登錄。 預設值:False。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az ml compute list
列出工作區中的計算目標。
az ml compute list --resource-group
--workspace-name
[--max-results]
[--type]
範例
使用 --query 自變數在工作區中列出所有計算目標,以在命令結果上執行 JMESPath 查詢。
az ml compute list --query "[].{Name:name}" --output table --resource-group my-resource-group --workspace-name my-workspace
必要參數
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>
。
選擇性參數
要傳回的結果數目上限。
計算目標的型別。 允許的值:AmlCompute、ComputeInstance、Kubernetes。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az ml compute list-nodes
列出計算目標的節點詳細數據。 此命令唯一支援的計算類型是 AML 計算。
az ml compute list-nodes --name
--resource-group
--workspace-name
範例
列出 AML 計算目標的節點詳細數據
az ml compute list-nodes --name nc6-cluster --resource-group my-resource-group --workspace-name my-workspace
必要參數
計算目標的名稱(如果未在 yaml 檔案中指定,則為必要專案)。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>
。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az ml compute list-sizes
列出依位置可用的 VM 大小。
az ml compute list-sizes --resource-group
--workspace-name
[--location]
[--type]
必要參數
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>
。
選擇性參數
位置。 值的來源:az account list-locations
。 您可以使用 az configure --defaults location=<location>
設定預設位置。
計算目標的型別。 允許的值:AmlCompute、ComputeInstance。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az ml compute list-usage
列出 VM 的可用使用量資源。
az ml compute list-usage --resource-group
--workspace-name
[--location]
必要參數
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>
。
選擇性參數
預設為工作區位置。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az ml compute restart
重新啟動 ComputeInstance 目標。
建議使用 --no-wait 選項。
az ml compute restart --name
--resource-group
--workspace-name
[--no-wait]
必要參數
計算目標的名稱(如果未在 yaml 檔案中指定,則為必要專案)。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>
。
選擇性參數
請勿等候長時間執行的作業完成。 預設值是 False。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az ml compute show
顯示計算目標的詳細數據。
az ml compute show --name
--resource-group
--workspace-name
範例
顯示計算目標的詳細數據
az ml compute show --name nc6-cluster --resource-group my-resource-group --workspace-name my-workspace
必要參數
計算目標的名稱(如果未在 yaml 檔案中指定,則為必要專案)。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>
。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az ml compute start
啟動 ComputeInstance 目標。
建議使用 --no-wait 選項。
az ml compute start --name
--resource-group
--workspace-name
[--no-wait]
必要參數
計算目標的名稱(如果未在 yaml 檔案中指定,則為必要專案)。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>
。
選擇性參數
請勿等候長時間執行的作業完成。 預設值是 False。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az ml compute stop
停止 ComputeInstance 目標。
建議使用 --no-wait 選項。
az ml compute stop --name
--resource-group
--workspace-name
[--no-wait]
必要參數
計算目標的名稱(如果未在 yaml 檔案中指定,則為必要專案)。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>
。
選擇性參數
請勿等候長時間執行的作業完成。 預設值是 False。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az ml compute update
更新計算目標。
可以更新 'tags'、'max_instances'、'min_instances'、'idle_time_before_scale_down'、'identity_type'和 'user_assigned_identities' 屬性。
az ml compute update --name
--resource-group
--workspace-name
[--add]
[--force-string]
[--identity-type]
[--idle-time-before-scale-down]
[--max-instances]
[--min-instances]
[--no-wait]
[--remove]
[--set]
[--tags]
[--user-assigned-identities]
範例
更新 AmlCompute 叢集的節點數目下限
az ml compute update --name nc6-cluster --min-instances 1 --resource-group my-resource-group --workspace-name my-workspace
更新現有的標籤或新增 AmlCompute 叢集的新標籤
az ml compute update --name nc6-cluster --tags key1=value1 key2=value2 --resource-group my-resource-group --workspace-name my-workspace
必要參數
計算目標的名稱(如果未在 yaml 檔案中指定,則為必要專案)。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
Azure ML 工作區的名稱。 您可以使用 來設定預設工作區 az configure --defaults workspace=<name>
。
選擇性參數
藉由指定路徑和索引鍵值組,將物件加入物件清單。 範例:--add property.listProperty <key=value, string or JSON string>
。
使用 'set' 或 'add' 時,請保留字串常值,而不是嘗試轉換成 JSON。
受控識別的類型。 允許的值:SystemAssigned、UserAssigned。
在相應減少叢集之前,以秒為單位的節點空閒時間。 默認值:120。
要使用的節點數目上限。 默認值:4。
要使用的節點數目下限。 預設:0。
請勿等候長時間執行的作業完成。 預設值是 False。
從清單中移除屬性或專案。 範例: --remove property.list <indexToRemove>
或 --remove propertyToRemove
。
指定要設定的屬性路徑和值,以更新物件。 範例:--set property1.property2=<value>
。
對象標記的空間分隔索引鍵/值組。
使用 '[system]' 來設定系統指派的身分識別,否則輸入資源標識符會以逗號 (ie ,) 分隔,以設定使用者指派的身分識別。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。