Partilhar via


ComputeInstance Classe

Gere um ambiente de desenvolvimento de ML otimizado e baseado na cloud no Azure Machine Learning.

Uma instância de computação do Azure Machine Learning é um ambiente de desenvolvimento totalmente configurado e gerido na cloud otimizado para fluxos de trabalho de desenvolvimento de machine learning. A ComputeInstance é normalmente utilizada para criar um ambiente de desenvolvimento ou como um destino de computação para preparação e inferência para desenvolvimento e teste. Com uma ComputeInstance, pode criar, preparar e implementar modelos numa experiência de bloco de notas totalmente integrada na sua área de trabalho. Para obter mais informações, veja O que é uma instância de computação do Azure Machine Learning?.

Construtor Class ComputeTarget.

Obtenha uma representação na cloud de um objeto de Computação associado à área de trabalho fornecida. Devolve uma instância de uma classe subordinada correspondente ao tipo específico do objeto de Computação obtido.

Herança
ComputeInstance

Construtor

ComputeInstance(workspace, name)

Parâmetros

workspace
Workspace
Necessário

O objeto da área de trabalho que contém o objeto Computação a obter.

name
str
Necessário

O nome do objeto Computação a obter.

Métodos

delete

Remova o objeto ComputeInstance da área de trabalho associada.

deserialize

Converta um objeto JSON num objeto ComputeInstance.

Isto falha se a área de trabalho fornecida não for a área de trabalho à que a ComputeInstance está associada.

detach

A desanexação não é suportada para o objeto ComputeInstance. Em vez disso, utilize delete.

get

Devolver objeto ComputeInstance.

get_active_runs

Devolver um gerador das execuções para esta computação.

get_docs_url

Url para a documentação desta classe.

get_status

Obtenha o estado detalhado atual da ComputeInstance.

provisioning_configuration

Crie um objeto de configuração para aprovisionar um destino ComputeInstance.

refresh_state

Efetue uma atualização no local das propriedades do objeto.

Este método atualiza as propriedades com base no estado atual do objeto de cloud correspondente. Isto é essencialmente útil para consultas manuais do estado de computação.

restart

Reinicie a ComputeInstance.

serialize

Converta este objeto ComputeInstance num dicionário serializado JSON.

start

Inicie a ComputeInstance.

stop

Pare a ComputeInstance.

supported_vmsizes

Liste os tamanhos de VM suportados numa região.

wait_for_completion

Aguarde que a ComputeInstance termine o aprovisionamento.

delete

Remova o objeto ComputeInstance da área de trabalho associada.

delete(wait_for_completion=False, show_output=False)

Parâmetros

wait_for_completion
valor predefinido: False
show_output
valor predefinido: False

Exceções

Observações

Se este objeto tiver sido criado através do Azure ML, os objetos baseados na cloud correspondentes também serão eliminados. Se este objeto tiver sido criado externamente e apenas anexado à área de trabalho, gerará uma exceção e nada será alterado.

deserialize

Converta um objeto JSON num objeto ComputeInstance.

Isto falha se a área de trabalho fornecida não for a área de trabalho à que a ComputeInstance está associada.

static deserialize(workspace, object_dict)

Parâmetros

workspace
Workspace
Necessário

O objeto da área de trabalho a que o objeto ComputeInstance está associado.

object_dict
dict
Necessário

Um objeto JSON para converter num objeto ComputeInstance.

Devoluções

A representação ComputeInstance do objeto JSON fornecido.

Tipo de retorno

Exceções

detach

A desanexação não é suportada para o objeto ComputeInstance. Em vez disso, utilize delete.

detach()

Exceções

A operação não é suprimida.

get

Devolver objeto ComputeInstance.

get()

Devoluções

A representação ComputeInstance do objeto JSON fornecido.

Tipo de retorno

Exceções

get_active_runs

Devolver um gerador das execuções para esta computação.

get_active_runs(type=None, tags=None, properties=None, status=None)

Parâmetros

type
str
valor predefinido: None

Filtre o gerador devolvido de execuções pelo tipo fornecido. Veja add_type_provider para criar tipos de execução.

tags
str ou dict
valor predefinido: None

O filtro é executado por "tag" ou {"tag": "value"}

properties
str ou dict
valor predefinido: None

O filtro é executado por "propriedade" ou {"property": "value"}

status
str
valor predefinido: None

O estado de execução pode ser "Em execução" ou "Em fila".

Devoluções

Um gerador de azureml._restclient.models.RunDto

Tipo de retorno

<xref:builtin.generator>

Exceções

get_docs_url

Url para a documentação desta classe.

get_docs_url()

Devoluções

url

Tipo de retorno

str

Exceções

get_status

Obtenha o estado detalhado atual da ComputeInstance.

get_status()

Devoluções

Um objeto de estado detalhado para a computação

Tipo de retorno

Exceções

provisioning_configuration

Crie um objeto de configuração para aprovisionar um destino ComputeInstance.

static provisioning_configuration(vm_size='', ssh_public_access=False, admin_user_ssh_public_key=None, vnet_resourcegroup_name=None, vnet_name=None, subnet_name=None, tags=None, description=None, assigned_user_object_id=None, assigned_user_tenant_id=None)

Parâmetros

vm_size
str
Necessário

O tamanho das VMs do agente. Pode encontrar mais detalhes aqui: https://aka.ms/azureml-vm-details. Tenha em atenção que nem todos os tamanhos estão disponíveis em todas as regiões, conforme detalhado na ligação anterior. A predefinição é Standard_NC6.

ssh_public_access
bool
valor predefinido: False

Indica o estado da porta SSH pública. Os valores possíveis são:

  • Falso – a porta SSH pública está fechada.
  • True - A porta SSH pública está aberta.
admin_user_ssh_public_key
str
valor predefinido: None

A chave pública SSH da conta de utilizador do administrador.

vnet_resourcegroup_name
str
valor predefinido: None

O nome do grupo de recursos onde está localizada a rede virtual.

vnet_name
str
valor predefinido: None

O nome da rede virtual.

subnet_name
str
valor predefinido: None

O nome da sub-rede dentro da vnet.

tags
dict[str, str]
valor predefinido: None

Um dicionário opcional de etiquetas de valor chave para associar ao objeto de computação.

description
str
valor predefinido: None

Uma descrição opcional para o objeto de computação.

assigned_user_object_id
str
valor predefinido: None

O ID do Objeto do AAD do utilizador atribuído (pré-visualização).

assigned_user_tenant_id
str
valor predefinido: None

O ID do Inquilino do AAD do utilizador atribuído (pré-visualização).

Devoluções

Um objeto de configuração a ser utilizado ao criar um objeto de Computação.

Tipo de retorno

Exceções

refresh_state

Efetue uma atualização no local das propriedades do objeto.

Este método atualiza as propriedades com base no estado atual do objeto de cloud correspondente. Isto é essencialmente útil para consultas manuais do estado de computação.

refresh_state()

Exceções

restart

Reinicie a ComputeInstance.

restart(wait_for_completion=False, show_output=False)

Parâmetros

wait_for_completion
bool
valor predefinido: False

Booleano para aguardar a atualização de estado. Predefinições para Falso.

show_output
bool
valor predefinido: False

Booleano para fornecer uma saída mais verbosa. Predefinições para Falso.

Devoluções

Nenhuma

Tipo de retorno

Exceções

azureml.exceptions.ComputeTargetException:

serialize

Converta este objeto ComputeInstance num dicionário serializado JSON.

serialize()

Devoluções

A representação JSON deste objeto ComputeInstance.

Tipo de retorno

Exceções

start

Inicie a ComputeInstance.

start(wait_for_completion=False, show_output=False)

Parâmetros

wait_for_completion
bool
valor predefinido: False

Se pretende aguardar pela atualização de estado. Predefinições para Falso.

show_output
bool
valor predefinido: False

Se pretende fornecer uma saída mais verbosa. Predefinições para Falso.

Devoluções

Nenhuma

Tipo de retorno

Exceções

stop

Pare a ComputeInstance.

stop(wait_for_completion=False, show_output=False)

Parâmetros

wait_for_completion
bool
valor predefinido: False

Se pretende aguardar pela atualização de estado. Predefinições para Falso.

show_output
bool
valor predefinido: False

Se pretende fornecer uma saída mais verbosa. Predefinições para Falso.

Devoluções

Nenhuma

Tipo de retorno

Exceções

supported_vmsizes

Liste os tamanhos de VM suportados numa região.

static supported_vmsizes(workspace, location=None)

Parâmetros

workspace
Workspace
Necessário

A área de trabalho.

location
str
valor predefinido: None

A localização da instância. Se não for especificado, a predefinição é a localização da área de trabalho.

Devoluções

Uma lista de tamanhos de VM suportados numa região com o nome da VM, VCPUs e RAM.

Tipo de retorno

Exceções

wait_for_completion

Aguarde que a ComputeInstance termine o aprovisionamento.

wait_for_completion(show_output=False, is_delete_operation=False)

Parâmetros

show_output
bool
valor predefinido: False

Se pretende fornecer uma saída mais verbosa. A predefinição é Falso.

is_delete_operation
bool
valor predefinido: False

Indica se a operação se destina a eliminar.

Exceções