Compartilhar via

ComputeInstance Classe

  • Referência

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