Partilhar 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 que é otimizado para fluxos de trabalho de desenvolvimento de aprendizado de máquina. 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 uma ComputeInstance, você pode criar, treinar e implantar modelos em uma experiência de notebook totalmente integrada em seu espaço de trabalho. Para obter mais informações, consulte O que é uma instância de computação do Azure Machine Learning?.

Classe ComputeTarget construtor.

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

Construtor

ComputeInstance(workspace, name)

Parâmetros

Name Description
workspace
Necessário

O objeto de espaço de trabalho que contém o objeto Compute a ser recuperado.

name
Necessário
str

O nome do objeto Compute a ser recuperado.

Métodos

delete

Remova o objeto ComputeInstance de seu espaço de trabalho associado.

deserialize

Converter um objeto JSON em um objeto ComputeInstance.

Isso falhará se o espaço de trabalho fornecido não for o espaço de trabalho ao qual a ComputeInstance está associada.

detach

Desanexar não é suportado para o objeto ComputeInstance. Utilize delete em substituição.

get

Retornar objeto ComputeInstance.

get_active_runs

Retornar um gerador das execuções para este cálculo.

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.

Este 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 este objeto ComputeInstance em um dicionário serializado JSON.

start

Inicie o ComputeInstance.

stop

Pare o ComputeInstance.

supported_vmsizes

Liste os tamanhos de VM suportados 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 a ComputeInstance termine o provisionamento.

delete

Remova o objeto ComputeInstance de seu espaço de trabalho associado.

delete(wait_for_completion=False, show_output=False)

Parâmetros

Name Description
wait_for_completion
Default value: False
show_output
Default value: False

Exceções

Tipo Description

Observações

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 foi criado externamente e anexado apenas ao espaço de trabalho, ele gerará exceção e nada será alterado.

deserialize

Converter um objeto JSON em um objeto ComputeInstance.

Isso falhará se o espaço de trabalho fornecido não for o espaço de trabalho ao qual a ComputeInstance está associada.

static deserialize(workspace, object_dict)

Parâmetros

Name Description
workspace
Necessário

O objeto de espaço de trabalho ao qual o objeto ComputeInstance está associado.

object_dict
Necessário

Um objeto JSON para converter em um objeto ComputeInstance.

Devoluções

Tipo Description

A representação ComputeInstance do objeto JSON fornecido.

Exceções

Tipo Description

detach

Desanexar não é suportado para o objeto ComputeInstance. Utilize delete em substituição.

detach()

Exceções

Tipo Description

A operação não é supproted.

get

Retornar objeto ComputeInstance.

get()

Devoluções

Tipo Description

A representação ComputeInstance do objeto JSON fornecido.

Exceções

Tipo Description

get_active_runs

Retornar um gerador das execuções para este cálculo.

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

Parâmetros

Name Description
type
str

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

Default value: None
tags
str ou dict

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

Default value: None
properties
str ou dict

O filtro é executado por "propriedade" ou {"propriedade": "valor"}

Default value: None
status
str

Status de execução, pode ser "Em execução" ou "Em fila".

Default value: None

Devoluções

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

Devoluções

Tipo Description
str

URL

get_status

Recupere o status detalhado atual para o ComputeInstance.

get_status()

Devoluções

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

Name Description
vm_size
Necessá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:

  • Falso - A porta SSH pública está fechada.
  • True - A porta SSH pública está aberta.
Default value: False
admin_user_ssh_public_key
str

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

Default value: None
vnet_resourcegroup_name
str

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

Default value: None
vnet_name
str

O nome da rede virtual.

Default value: None
subnet_name
str

O nome da sub-rede dentro da vnet.

Default value: None
tags

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

Default value: None
description
str

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

Default value: None
assigned_user_object_id
str

O ID do objeto AAD do usuário atribuído (visualização).

Default value: None
assigned_user_tenant_id
str

O ID do locatário do AAD do usuário atribuído (visualização).

Default value: None

Devoluções

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.

Este 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

Name Description
wait_for_completion

Boolean para aguardar a atualização do estado. A definição padrão é 'False'.

Default value: False
show_output

Booleano para fornecer uma saída mais detalhada. A definição padrão é 'False'.

Default value: False

Devoluções

Tipo Description

Nenhum

Exceções

Tipo Description
azureml.exceptions.ComputeTargetException:

serialize

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

serialize()

Devoluções

Tipo Description

A representação JSON deste objeto ComputeInstance.

start

Inicie o ComputeInstance.

start(wait_for_completion=False, show_output=False)

Parâmetros

Name Description
wait_for_completion

Se deve aguardar a atualização do estado. A definição padrão é 'False'.

Default value: False
show_output

Se deve fornecer resultados mais detalhados. A definição padrão é 'False'.

Default value: False

Devoluções

Tipo Description

Nenhum

Exceções

Tipo Description

stop

Pare o ComputeInstance.

stop(wait_for_completion=False, show_output=False)

Parâmetros

Name Description
wait_for_completion

Se deve aguardar a atualização do estado. A definição padrão é 'False'.

Default value: False
show_output

Se deve fornecer resultados mais detalhados. A definição padrão é 'False'.

Default value: False

Devoluções

Tipo Description

Nenhum

Exceções

Tipo Description

supported_vmsizes

Liste os tamanhos de VM suportados em uma região.

static supported_vmsizes(workspace, location=None)

Parâmetros

Name Description
workspace
Necessário

O espaço de trabalho.

location
str

A localização da instância. Se não for especificado, o padrão é o local do espaço de trabalho.

Default value: None

Devoluções

Tipo Description

Uma lista de tamanhos de VM suportados 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

Name Description
value
Necessário

O valor das configurações de sso

Devoluções

Tipo Description

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

wait_for_completion

Aguarde até que a ComputeInstance termine o provisionamento.

wait_for_completion(show_output=False, is_delete_operation=False)

Parâmetros

Name Description
show_output

Se deve fornecer resultados mais detalhados. A definição padrão é 'False'.

Default value: False
is_delete_operation

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

Default value: False

Exceções

Tipo Description