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
ComputeInstance

Construtor

ComputeInstance(workspace, name)

Parâmetros

workspace
Workspace
Obrigatório

O objeto de workspace que contém o objeto Compute a ser recuperado.

name
str
Obrigatório

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

wait_for_completion
valor padrão: False
show_output
valor padrão: False

Exceções

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

workspace
Workspace
Obrigatório

O objeto de workspace ao qual o objeto ComputeInstance está associado.

object_dict
dict
Obrigatório

Um objeto JSON a ser convertido em um objeto ComputeInstance.

Retornos

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

Tipo de retorno

Exceções

detach

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

detach()

Exceções

A operação não tem suporte.

get

Retorna o objeto ComputeInstance.

get()

Retornos

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

Tipo de retorno

Exceções

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

type
str
valor padrão: None

Filtra o gerador de execuções retornado pelo tipo fornecido. Confira add_type_provider para criar tipos de execução.

tags
str ou dict
valor padrão: None

Filtra execuções por "marca" ou {"marca": "valor"}

properties
str ou dict
valor padrão: None

Filtra execuções por "propriedade" ou {"propriedade": "valor"}

status
str
valor padrão: None

O status da execução, pode ser "Em execução" ou "Enfileirado".

Retornos

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()

Retornos

url

Tipo de retorno

str

Exceções

get_status

Recupera o status detalhado atual do cluster para o ComputeInstance.

get_status()

Retornos

Um objeto de status detalhado para a computação

Tipo de retorno

Exceções

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

vm_size
str
Obrigatório

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
valor padrão: False

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.
admin_user_ssh_public_key
str
valor padrão: None

A chave pública SSH da conta do usuário administrador.

vnet_resourcegroup_name
str
valor padrão: None

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

vnet_name
str
valor padrão: None

O nome da rede virtual.

subnet_name
str
valor padrão: None

O nome da sub-rede dentro da VNet.

tags
dict[str, str]
valor padrão: None

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

description
str
valor padrão: None

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

assigned_user_object_id
str
valor padrão: None

A ID do objeto do AAD de usuário atribuído (versão prévia).

assigned_user_tenant_id
str
valor padrão: None

A ID do locatário do AAD de usuário atribuído (versão prévia).

Retornos

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

Tipo de retorno

Exceções

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

restart

Reinicie o ComputeInstance.

restart(wait_for_completion=False, show_output=False)

Parâmetros

wait_for_completion
bool
valor padrão: False

Booliano para aguardar a atualização de estado. Usa False como padrão.

show_output
bool
valor padrão: False

Booliano para fornecer uma saída mais detalhada. Usa False como padrão.

Retornos

Nenhum

Tipo de retorno

Exceções

azureml.exceptions.ComputeTargetException:

serialize

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

serialize()

Retornos

A representação JSON desse objeto ComputeInstance.

Tipo de retorno

Exceções

start

Inicia o ComputeInstance.

start(wait_for_completion=False, show_output=False)

Parâmetros

wait_for_completion
bool
valor padrão: False

Se a atualização de estado deve ou não ser aguardada. Usa False como padrão.

show_output
bool
valor padrão: False

Se uma saída mais detalhada deve ou não ser fornecida. Usa False como padrão.

Retornos

Nenhum

Tipo de retorno

Exceções

stop

Interrompe o ComputeInstance.

stop(wait_for_completion=False, show_output=False)

Parâmetros

wait_for_completion
bool
valor padrão: False

Se a atualização de estado deve ou não ser aguardada. Usa False como padrão.

show_output
bool
valor padrão: False

Se uma saída mais detalhada deve ou não ser fornecida. Usa False como padrão.

Retornos

Nenhum

Tipo de retorno

Exceções

supported_vmsizes

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

static supported_vmsizes(workspace, location=None)

Parâmetros

workspace
Workspace
Obrigatório

O workspace.

location
str
valor padrão: None

O local da instância. Se não for especificado, o local do workspace será usado por padrão.

Retornos

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

Tipo de retorno

Exceções

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

show_output
bool
valor padrão: False

Se uma saída mais detalhada deve ou não ser fornecida. Usa False como padrão.

is_delete_operation
bool
valor padrão: False

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

Exceções