Compartilhar via


ComputeInstance Classe

Gerencia um ambiente de desenvolvimento de ML otimizado e 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 otimizado para fluxos de trabalho de desenvolvimento de machine learning. O 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 em 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 de computação associado ao workspace fornecido. Retorna uma instância de uma classe filho correspondente ao tipo específico do objeto compute recuperado.

Construtor

ComputeInstance(workspace, name)

Parâmetros

Nome Description
workspace
Obrigatório

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

name
Obrigatório
str

O nome do objeto Compute a ser recuperado.

Métodos

delete

Remova o objeto ComputeInstance de seu workspace associado.

deserialize

Converta um objeto JSON em um objeto ComputeInstance.

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

detach

Não há suporte para desanexar para o objeto ComputeInstance. Use delete em seu lugar.

get

Retornar objeto ComputeInstance.

get_active_runs

Retornar um gerador das execuções para essa computação.

get_docs_url

Url para a documentação desta classe.

get_status

Recupere o status detalhado atual para o ComputeInstance.

provisioning_configuration

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

refresh_state

Execute uma atualização in-loco 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

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

start

Inicie o ComputeInstance.

stop

Pare o ComputeInstance.

supported_vmsizes

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

update_sso_settings

Atualize as configurações de logon único da instância de computação.

wait_for_completion

Aguarde até que o ComputeInstance conclua o provisionamento.

delete

Remova o objeto ComputeInstance de seu 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

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 anexado apenas ao workspace, ele gerará exceção e nada será alterado.

deserialize

Converta um objeto JSON em um objeto ComputeInstance.

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

static deserialize(workspace, object_dict)

Parâmetros

Nome Description
workspace
Obrigatório

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

object_dict
Obrigatório

Um objeto JSON a ser convertido em um objeto ComputeInstance.

Retornos

Tipo Description

A representação ComputeInstance do objeto JSON fornecido.

Exceções

Tipo Description

detach

Não há suporte para desanexar para o objeto ComputeInstance. Use delete em seu lugar.

detach()

Exceções

Tipo Description

A operação não é supracitada.

get

Retornar objeto ComputeInstance.

get()

Retornos

Tipo Description

A representação ComputeInstance do objeto JSON fornecido.

Exceções

Tipo Description

get_active_runs

Retornar um gerador das execuções para essa computação.

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

Parâmetros

Nome Description
type
str

Filtre o gerador retornado de execuções pelo tipo fornecido. Consulte add_type_provider como criar tipos de execução.

Valor padrão: None
tags
str ou dict

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

Valor padrão: None
properties
str ou dict

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

Valor padrão: None
status
str

O status de 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

get_docs_url

Url para a documentação desta classe.

get_docs_url()

Retornos

Tipo Description
str

URL

get_status

Recupere o status detalhado atual para o ComputeInstance.

get_status()

Retornos

Tipo Description

Um objeto de status detalhado para a computação

provisioning_configuration

Crie 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

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

  • False – A porta SSH pública está fechada.
  • True – A porta SSH pública está 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 em que 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

Um dicionário opcional de marcas de valor de chave a serem associadas 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 de objeto do AAD do usuário atribuído (versão prévia).

Valor padrão: None
assigned_user_tenant_id
str

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

Valor padrão: None

Retornos

Tipo Description

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

Exceções

Tipo Description

refresh_state

Execute uma atualização in-loco 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()

restart

Reinicie o ComputeInstance.

restart(wait_for_completion=False, show_output=False)

Parâmetros

Nome Description
wait_for_completion

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

Valor padrão: False
show_output

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

Valor padrão: False

Retornos

Tipo Description

Nenhum

Exceções

Tipo Description
azureml.exceptions.ComputeTargetException:

serialize

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

serialize()

Retornos

Tipo Description

A representação JSON deste objeto ComputeInstance.

start

Inicie o ComputeInstance.

start(wait_for_completion=False, show_output=False)

Parâmetros

Nome Description
wait_for_completion

Se deve aguardar a atualização de estado. Usa False como padrão.

Valor padrão: False
show_output

Se deseja fornecer uma saída mais detalhada. Usa False como padrão.

Valor padrão: False

Retornos

Tipo Description

Nenhum

Exceções

Tipo Description

stop

Pare o ComputeInstance.

stop(wait_for_completion=False, show_output=False)

Parâmetros

Nome Description
wait_for_completion

Se deve aguardar a atualização de estado. Usa False como padrão.

Valor padrão: False
show_output

Se deseja fornecer uma saída mais detalhada. Usa False como padrão.

Valor padrão: False

Retornos

Tipo Description

Nenhum

Exceções

Tipo Description

supported_vmsizes

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

static supported_vmsizes(workspace, location=None)

Parâmetros

Nome Description
workspace
Obrigatório

O workspace.

location
str

O local da instância. Se não for especificado, o padrão é o local do workspace.

Valor padrão: None

Retornos

Tipo Description

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

update_sso_settings

Atualize as configurações de logon único da instância de computação.

update_sso_settings(value)

Parâmetros

Nome Description
value
Obrigatório

O valor das configurações de sso

Retornos

Tipo Description

Se a atualização foi bem-sucedida ou não

wait_for_completion

Aguarde até que o ComputeInstance conclua o provisionamento.

wait_for_completion(show_output=False, is_delete_operation=False)

Parâmetros

Nome Description
show_output

Se deseja fornecer uma saída mais detalhada. Usa False como padrão.

Valor padrão: False
is_delete_operation

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

Valor padrão: False

Exceções

Tipo Description