az ml compute
Observação
Essa referência faz parte da extensão ml para a CLI do Azure (versão 2.15.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az ml compute . Saiba mais sobre extensões.
Gerenciar recursos de computação do Azure ML.
Os destinos de computação do Azure ML são recursos de computação designados onde você pode executar seus trabalhos para treinamento ou implantar seus modelos para inferência.
Comandos
Nome | Description | Tipo | Status |
---|---|---|---|
az ml compute attach |
Anexe um recurso de computação existente a um espaço de trabalho. |
Extensão | GA |
az ml compute connect-ssh |
Configure a conexão SSH com a instância de computação. |
Extensão | Visualizar |
az ml compute create |
Crie um destino de computação. |
Extensão | GA |
az ml compute delete |
Excluir um destino de computação. |
Extensão | GA |
az ml compute detach |
Desanexe um recurso de computação anexado anteriormente de um espaço de trabalho. |
Extensão | GA |
az ml compute list |
Listar os destinos de computação em um espaço de trabalho. |
Extensão | GA |
az ml compute list-nodes |
Listar detalhes do nó para um destino de computação. O único tipo de computação com suporte para esse comando é a computação AML. |
Extensão | GA |
az ml compute list-sizes |
Liste os tamanhos de VM disponíveis por local. |
Extensão | GA |
az ml compute list-usage |
Liste os recursos de uso disponíveis para VMs. |
Extensão | GA |
az ml compute restart |
Reinicie um destino ComputeInstance. |
Extensão | GA |
az ml compute show |
Mostrar detalhes de um destino de computação. |
Extensão | GA |
az ml compute start |
Inicie um destino ComputeInstance. |
Extensão | GA |
az ml compute stop |
Pare um destino ComputeInstance. |
Extensão | GA |
az ml compute update |
Atualizar um destino de computação. |
Extensão | GA |
az ml compute attach
Anexe um recurso de computação existente a um espaço de trabalho.
Clusters Kubernetes e VMs remotas podem ser anexados como destinos de computação.
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]
Parâmetros Exigidos
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome do espaço de trabalho do Azure ML. Você pode configurar o espaço de trabalho padrão usando az configure --defaults workspace=<name>
o .
Parâmetros Opcionais
A senha de usuário do administrador que pode ser usada para SSH no(s) nó(s).
Nome da conta de usuário do administrador que pode ser usada para SSH no(s) nó(s).
Caminho local para o arquivo YAML que contém a especificação de computação do Azure ML.
O tipo de identidade manejada. Valores permitidos: SystemAssigned, UserAssigned.
Nome do destino de computação (Obrigatório se não especificado no arquivo yaml).
namespace de um KubernetesCompute.
Não aguarde a conclusão da operação de execução longa.
A ID totalmente qualificada do recurso, incluindo o nome do recurso e o tipo de recurso (Obrigatório se não especificado no arquivo yaml).
O número da porta que pode ser usado para SSH no(s) nó(s). Se não for especificado, o padrão (porta 22) será usado.
O arquivo que contém a chave privada SSH da conta de usuário administrador.
O tipo de destino de computação. Valores permitidos: virtualmachine, Kubernetes.
O ID de recurso da identidade atribuída ao usuário, necessário para --identity_type=UserAssigned.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az ml compute connect-ssh
Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Configure a conexão SSH com a instância de computação.
az ml compute connect-ssh --name
--resource-group
--workspace-name
[--private-key-file-path]
Exemplos
Conectar-se a uma instância de computação via SSH
az ml compute connect-ssh --name ci1 --resource-group my-resource-group --workspace-name my-workspace --private-key-file-path sshkey.pem
Parâmetros Exigidos
Nome do destino da computação. Obrigatória.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome do espaço de trabalho do Azure ML. Você pode configurar o espaço de trabalho padrão usando az configure --defaults workspace=<name>
o .
Parâmetros Opcionais
O caminho para o arquivo de arquivo de chave privada.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az ml compute create
Crie um destino de computação.
Você pode criar um cluster AmlCompute, que é a infraestrutura de computação gerenciada do Azure ML, ou uma instância de computação, que é uma estação de trabalho gerenciada baseada em nuvem.
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]
Exemplos
Criar um destino de computação a partir de um arquivo de especificação YAML
az ml compute create --file compute.yml --resource-group my-resource-group --workspace-name my-workspace
Criar um destino AmlCompute usando opções de comando
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
Parâmetros Exigidos
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome do espaço de trabalho do Azure ML. Você pode configurar o espaço de trabalho padrão usando az configure --defaults workspace=<name>
o .
Parâmetros Opcionais
Senha da conta de usuário administrador se o tipo de autenticação for 'Senha'.
Nome da conta de usuário do administrador que pode ser usada para SSH no(s) nó(s).
Descrição do destino de computação.
Indica se o IP público está habilitado. Padrão: Verdadeiro.
Caminho local para o arquivo YAML que contém a especificação de computação do Azure ML. Os documentos de referência do YAML para computação podem ser encontrados em: 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.
O tipo de identidade gerenciada. Valores permitidos: SystemAssigned, UserAssigned.
Tempo ocioso do nó em segundos antes de reduzir verticalmente o cluster. Padrão: 120.
Localização da computação. Se não for especificado, o padrão será o local do espaço de trabalho.
O número máximo de nós a ser usado no cluster. Padrão: 4.
O número mínimo de nós a ser usado no cluster. Padrão: 0.
Nome do destino da computação. Obrigatório se --file/-f não for fornecido.
Não espere que a operação de longa duração termine. O padrão é Falso.
Atualize um objeto especificando um caminho de propriedade e um valor a serem definidos. Exemplo: --set property1.property2=.
Tamanho da VM a ser usado para o destino de computação. Mais detalhes podem ser encontrados aqui: https://aka.ms/azureml-vm-details.
Chave pública SSH da conta de usuário do administrador.
Indica se a porta SSH pública está habilitada.
Nome da sub-rede. Também pode fazer referência a uma sub-rede em uma rede virtual existente por ID em vez de nome. Se o ID da sub-rede for especificado, o vnet-name será ignorado. A ID da sub-rede pode se referir a uma vnet/sub-rede em outro RG especificando a ID da sub-rede totalmente qualificada. Obrigatório quando o nome vnet é especificado.
Pares chave-valor separados por espaço para as marcas do objeto.
Camada de prioridade da VM. Valores permitidos: dedicado, low_priority.
O tipo de destino de computação. Obrigatório se --file/-f não for fornecido. Valores permitidos: AmlCompute, ComputeInstance.
Use '[system]' para definir uma identidade atribuída ao sistema senão IDs de recursos de entrada separados por vírgulas (ou seja, ,) para definir identidades atribuídas pelo usuário.
ID do objeto AAD do usuário atribuído.
ID do locatário do AAD do usuário atribuído.
Nome da rede virtual.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az ml compute delete
Excluir um destino de computação.
az ml compute delete --name
--resource-group
--workspace-name
[--no-wait]
[--yes]
Parâmetros Exigidos
Nome do destino de computação (Obrigatório se não especificado no arquivo yaml).
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome do espaço de trabalho do Azure ML. Você pode configurar o espaço de trabalho padrão usando az configure --defaults workspace=<name>
o .
Parâmetros Opcionais
Não espere que a operação de longa duração termine. O padrão é Falso.
Não solicite confirmação.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az ml compute detach
Desanexe um recurso de computação anexado anteriormente de um espaço de trabalho.
az ml compute detach --name
--resource-group
--workspace-name
[--no-wait]
[--yes]
Parâmetros Exigidos
Nome do destino de computação (Obrigatório se não especificado no arquivo yaml).
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome do espaço de trabalho do Azure ML. Você pode configurar o espaço de trabalho padrão usando az configure --defaults workspace=<name>
o .
Parâmetros Opcionais
Não aguarde a conclusão da operação de execução longa.
Não solicite confirmação.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az ml compute list
Listar os destinos de computação em um espaço de trabalho.
az ml compute list --resource-group
--workspace-name
[--max-results]
[--type]
Exemplos
Liste todos os destinos de computação em um espaço de trabalho usando o argumento --query para executar uma consulta JMESPath nos resultados dos comandos.
az ml compute list --query "[].{Name:name}" --output table --resource-group my-resource-group --workspace-name my-workspace
Parâmetros Exigidos
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome do espaço de trabalho do Azure ML. Você pode configurar o espaço de trabalho padrão usando az configure --defaults workspace=<name>
o .
Parâmetros Opcionais
Número máximo de resultados a serem retornados.
O tipo de destino de computação. Valores permitidos: AmlCompute, ComputeInstance, Kubernetes.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az ml compute list-nodes
Listar detalhes do nó para um destino de computação. O único tipo de computação com suporte para esse comando é a computação AML.
az ml compute list-nodes --name
--resource-group
--workspace-name
Exemplos
Listar detalhes do nó para um destino de computação AML
az ml compute list-nodes --name nc6-cluster --resource-group my-resource-group --workspace-name my-workspace
Parâmetros Exigidos
Nome do destino de computação (Obrigatório se não especificado no arquivo yaml).
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome do espaço de trabalho do Azure ML. Você pode configurar o espaço de trabalho padrão usando az configure --defaults workspace=<name>
o .
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az ml compute list-sizes
Liste os tamanhos de VM disponíveis por local.
az ml compute list-sizes --resource-group
--workspace-name
[--location]
[--type]
Parâmetros Exigidos
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome do espaço de trabalho do Azure ML. Você pode configurar o espaço de trabalho padrão usando az configure --defaults workspace=<name>
o .
Parâmetros Opcionais
Local. Valores de: az account list-locations
. Você pode configurar o local padrão usando az configure --defaults location=<location>
.
O tipo de destino de computação. Valores permitidos: AmlCompute, ComputeInstance.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az ml compute list-usage
Liste os recursos de uso disponíveis para VMs.
az ml compute list-usage --resource-group
--workspace-name
[--location]
Parâmetros Exigidos
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome do espaço de trabalho do Azure ML. Você pode configurar o espaço de trabalho padrão usando az configure --defaults workspace=<name>
o .
Parâmetros Opcionais
O padrão é o local do espaço de trabalho.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az ml compute restart
Reinicie um destino ComputeInstance.
--no-wait opção é recomendado.
az ml compute restart --name
--resource-group
--workspace-name
[--no-wait]
Parâmetros Exigidos
Nome do destino de computação (Obrigatório se não especificado no arquivo yaml).
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome do espaço de trabalho do Azure ML. Você pode configurar o espaço de trabalho padrão usando az configure --defaults workspace=<name>
o .
Parâmetros Opcionais
Não espere que a operação de longa duração termine. O padrão é Falso.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az ml compute show
Mostrar detalhes de um destino de computação.
az ml compute show --name
--resource-group
--workspace-name
Exemplos
Mostrar detalhes de um destino de computação
az ml compute show --name nc6-cluster --resource-group my-resource-group --workspace-name my-workspace
Parâmetros Exigidos
Nome do destino de computação (Obrigatório se não especificado no arquivo yaml).
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome do espaço de trabalho do Azure ML. Você pode configurar o espaço de trabalho padrão usando az configure --defaults workspace=<name>
o .
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az ml compute start
Inicie um destino ComputeInstance.
--no-wait opção é recomendado.
az ml compute start --name
--resource-group
--workspace-name
[--no-wait]
Parâmetros Exigidos
Nome do destino de computação (Obrigatório se não especificado no arquivo yaml).
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome do espaço de trabalho do Azure ML. Você pode configurar o espaço de trabalho padrão usando az configure --defaults workspace=<name>
o .
Parâmetros Opcionais
Não espere que a operação de longa duração termine. O padrão é Falso.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az ml compute stop
Pare um destino ComputeInstance.
--no-wait opção é recomendado.
az ml compute stop --name
--resource-group
--workspace-name
[--no-wait]
Parâmetros Exigidos
Nome do destino de computação (Obrigatório se não especificado no arquivo yaml).
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome do espaço de trabalho do Azure ML. Você pode configurar o espaço de trabalho padrão usando az configure --defaults workspace=<name>
o .
Parâmetros Opcionais
Não espere que a operação de longa duração termine. O padrão é Falso.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az ml compute update
Atualizar um destino de computação.
As propriedades 'tags', 'max_instances', 'min_instances', 'idle_time_before_scale_down', 'identity_type' e 'user_assigned_identities' podem ser atualizadas.
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]
Exemplos
Atualizar o número mínimo de nós para um cluster AmlCompute
az ml compute update --name nc6-cluster --min-instances 1 --resource-group my-resource-group --workspace-name my-workspace
Atualizar marcas existentes ou adicionar novas marcas para um cluster AmlCompute
az ml compute update --name nc6-cluster --tags key1=value1 key2=value2 --resource-group my-resource-group --workspace-name my-workspace
Parâmetros Exigidos
Nome do destino de computação (Obrigatório se não especificado no arquivo yaml).
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome do espaço de trabalho do Azure ML. Você pode configurar o espaço de trabalho padrão usando az configure --defaults workspace=<name>
o .
Parâmetros Opcionais
Adicione um objeto a uma lista de objetos especificando um caminho e pares de valores de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>
.
Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter para JSON.
O tipo de identidade gerenciada. Valores permitidos: SystemAssigned, UserAssigned.
Tempo ocioso do nó em segundos antes de reduzir verticalmente o cluster. Padrão: 120.
Número máximo de nós a serem usados. Padrão: 4.
Número mínimo de nós a serem usados. Padrão: 0.
Não espere que a operação de longa duração termine. O padrão é Falso.
Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove>
OU --remove propertyToRemove
.
Atualize um objeto especificando um caminho de propriedade e um valor a serem definidos. Exemplo: --set property1.property2=<value>
.
Pares chave-valor separados por espaço para as marcas do objeto.
Use '[system]' para definir uma identidade atribuída ao sistema senão IDs de recursos de entrada separados por vírgulas (ou seja, ,) para definir identidades atribuídas pelo usuário.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de