ComputeInstance Classe

Gerencia um ambiente de desenvolvimento de ML otimizado baseado em nuvem no Azure Machine Learning.

Uma instância de computação do Azure Machine Learning é um ambiente de desenvolvimento totalmente configurado e gerenciado na nuvem que é otimizado para fluxos de trabalho de desenvolvimento de machine learning. ComputeInstance é normalmente usado para criar um ambiente de desenvolvimento ou como um destino de computação para treinamento e inferência para desenvolvimento e teste. Com um ComputeInstance, você pode criar, treinar e implantar modelos em uma experiência de notebook totalmente integrada no seu workspace. Para saber mais, confira O que é uma instância de computação no Azure Machine Learning?.

Construtor ComputeTarget de classe.

Recupere uma representação na nuvem de um objeto Compute associado ao workspace fornecido. Retorna uma instância de uma classe filho correspondente ao tipo específico do objeto Compute recuperado.

Herança

ComputeTarget

ComputeInstance

Construtor

ComputeInstance(workspace, name)

Parâmetros

Nome	Description
workspace Obrigatório	Workspace O objeto de workspace que contém o objeto Compute a ser recuperado.
name Obrigatório	str O nome do do objeto Compute a ser recuperado.

Métodos

delete	Remova o objeto ComputeInstance do workspace associado.
deserialize	Converte um objeto JSON em um objeto ComputeInstance. Isso falhará se o workspace fornecido não for o workspace ao qual a ComputeInstance está associada.
detach	O método detach não é compatível com o objeto ComputeInstance. Use delete em vez disso.
get	Retorna o objeto ComputeInstance.
get_active_runs	Retorna um gerador de execuções para essa computação.
get_docs_url	URL para a documentação desta classe.
get_status	Recupera o status detalhado atual do cluster para o ComputeInstance.
provisioning_configuration	Cria um objeto de configuração para provisionar um destino ComputeInstance.
refresh_state	Executar uma atualização local das propriedades do objeto. Esse método atualiza as propriedades com base no estado atual do objeto de nuvem correspondente. Isso é útil principalmente para sondagem manual do estado de computação.
restart	Reinicie o ComputeInstance.
serialize	Converte esse objeto ComputeInstance em um dicionário serializado JSON.
start	Inicia o ComputeInstance.
stop	Interrompe o ComputeInstance.
supported_vmsizes	Lista os tamanhos de VM com suporte em uma região.
wait_for_completion	Aguarde até que o provisionamento de ComputeInstance seja concluído.

delete

Remova o objeto ComputeInstance do workspace associado.

delete(wait_for_completion=False, show_output=False)

Parâmetros

Nome	Description
wait_for_completion	Valor padrão: False
show_output	Valor padrão: False

Exceções

Tipo	Description
ComputeTargetException

Comentários

Se esse objeto tiver sido criado por meio do Azure ML, os objetos baseados em nuvem correspondentes também serão excluídos. Se esse objeto tiver sido criado externamente e apenas anexado ao workspace, ele gerará uma exceção e nada será alterado.

deserialize

Converte um objeto JSON em um objeto ComputeInstance.

Isso falhará se o workspace fornecido não for o workspace ao qual a ComputeInstance está associada.

static deserialize(workspace, object_dict)

Parâmetros

Nome	Description
workspace Obrigatório	Workspace O objeto de workspace ao qual o objeto ComputeInstance está associado.
object_dict Obrigatório	dict Um objeto JSON a ser convertido em um objeto ComputeInstance.

Retornos

Tipo	Description
ComputeInstance	A representação de ComputeInstance do objeto JSON fornecido.

Exceções

Tipo	Description
ComputeTargetException

detach

O método detach não é compatível com o objeto ComputeInstance. Use delete em vez disso.

detach()

Exceções

Tipo	Description
ComputeTargetException	A operação não tem suporte.

get

Retorna o objeto ComputeInstance.

get()

Retornos

Tipo	Description
ComputeInstance	A representação de ComputeInstance do objeto JSON fornecido.

Exceções

Tipo	Description
ComputeTargetException

get_active_runs

Retorna um gerador de execuções para essa computação.

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

Parâmetros

Nome	Description
type	str Filtra o gerador de execuções retornado pelo tipo fornecido. Confira add_type_provider para criar tipos de execução. Valor padrão: None
tags	str ou dict Filtra execuções por "marca" ou {"marca": "valor"} Valor padrão: None
properties	str ou dict Filtra execuções por "propriedade" ou {"propriedade": "valor"} Valor padrão: None
status	str O status da execução, pode ser "Em execução" ou "Enfileirado". Valor padrão: None

Retornos

Tipo	Description
<xref:builtin.generator>	Um gerador de azureml._restclient.models.RunDto

Exceções

Tipo	Description
ComputeTargetException

get_docs_url

URL para a documentação desta classe.

get_docs_url()

Retornos

Tipo	Description
str	url

Exceções

Tipo	Description
ComputeTargetException

get_status

Recupera o status detalhado atual do cluster para o ComputeInstance.

get_status()

Retornos

Tipo	Description
ComputeInstanceStatus	Um objeto de status detalhado para a computação

Exceções

Tipo	Description
ComputeTargetException

provisioning_configuration

Cria um objeto de configuração para provisionar 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

Nome	Description
vm_size Obrigatório	str O tamanho das VMs do agente. Mais detalhes podem ser encontrados aqui: https://aka.ms/azureml-vm-details. Observe que nem todos os tamanhos estão disponíveis em todas as regiões, conforme detalhado no link anterior. O padrão é Standard_NC6.
ssh_public_access	bool Indica o estado da porta SSH pública. Os valores possíveis são: False – A porta SSH pública é fechada. True – A porta SSH pública é aberta. Valor padrão: False
admin_user_ssh_public_key	str A chave pública SSH da conta do usuário administrador. Valor padrão: None
vnet_resourcegroup_name	str O nome do grupo de recursos no qual a rede virtual está localizada. Valor padrão: None
vnet_name	str O nome da rede virtual. Valor padrão: None
subnet_name	str O nome da sub-rede dentro da VNet. Valor padrão: None
tags	dict[str, str] Um dicionário opcional de marcas de valor de chave para associar ao objeto de computação. Valor padrão: None
description	str Uma descrição opcional para o objeto de computação. Valor padrão: None
assigned_user_object_id	str A ID do objeto do AAD de usuário atribuído (versão prévia). Valor padrão: None
assigned_user_tenant_id	str A ID do locatário do AAD de usuário atribuído (versão prévia). Valor padrão: None

Retornos

Tipo	Description
ComputeInstanceProvisioningConfiguration	Um objeto de configuração a ser usado ao criar um objeto Compute.

Exceções

Tipo	Description
ComputeTargetException

refresh_state

Executar uma atualização local das propriedades do objeto.

Esse método atualiza as propriedades com base no estado atual do objeto de nuvem correspondente. Isso é útil principalmente para sondagem manual do estado de computação.

refresh_state()

Exceções

Tipo	Description
ComputeTargetException

restart

Reinicie o ComputeInstance.

restart(wait_for_completion=False, show_output=False)

Parâmetros

Nome	Description
wait_for_completion	bool Booliano para aguardar a atualização de estado. Usa False como padrão. Valor padrão: False
show_output	bool Booliano para fornecer uma saída mais detalhada. Usa False como padrão. Valor padrão: False

Retornos

Tipo	Description
None	Nenhum

Exceções

Tipo	Description
azureml.exceptions.ComputeTargetException:

serialize

Converte esse objeto ComputeInstance em um dicionário serializado JSON.

serialize()

Retornos

Tipo	Description
dict	A representação JSON desse objeto ComputeInstance.

Exceções

Tipo	Description
ComputeTargetException

start

Inicia o ComputeInstance.

start(wait_for_completion=False, show_output=False)

Parâmetros

Nome	Description
wait_for_completion	bool Se a atualização de estado deve ou não ser aguardada. Usa False como padrão. Valor padrão: False
show_output	bool Se uma saída mais detalhada deve ou não ser fornecida. Usa False como padrão. Valor padrão: False

Retornos

Tipo	Description
None	Nenhum

Exceções

Tipo	Description
ComputeTargetException

stop

Interrompe o ComputeInstance.

stop(wait_for_completion=False, show_output=False)

Parâmetros

Nome	Description
wait_for_completion	bool Se a atualização de estado deve ou não ser aguardada. Usa False como padrão. Valor padrão: False
show_output	bool Se uma saída mais detalhada deve ou não ser fornecida. Usa False como padrão. Valor padrão: False

Retornos

Tipo	Description
None	Nenhum

Exceções

Tipo	Description
ComputeTargetException

supported_vmsizes

Lista os tamanhos de VM com suporte em uma região.

static supported_vmsizes(workspace, location=None)

Parâmetros

Nome	Description
workspace Obrigatório	Workspace O workspace.
location	str O local da instância. Se não for especificado, o local do workspace será usado por padrão. Valor padrão: None

Retornos

Tipo	Description
list	Uma lista de tamanhos de VM com suporte em uma região com nomes de VM, VCPUs e RAM.

Exceções

Tipo	Description
ComputeTargetException

wait_for_completion

Aguarde até que o provisionamento de ComputeInstance seja concluído.

wait_for_completion(show_output=False, is_delete_operation=False)

Parâmetros

Nome	Description
show_output	bool Se uma saída mais detalhada deve ou não ser fornecida. Usa False como padrão. Valor padrão: False
is_delete_operation	bool Indica se a operação se destina a exclusão. Valor padrão: False

Exceções

Tipo	Description
ComputeTargetException