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
|
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
|
Filtre o gerador retornado de execuções pelo tipo fornecido. Consulte add_type_provider para criar tipos de execução. Default value: None
|
|
tags
|
O filtro é executado por "tag" ou {"tag": "value"} Default value: None
|
|
properties
|
O filtro é executado por "propriedade" ou {"propriedade": "valor"} Default value: None
|
|
status
|
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
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
|
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:
Default value: False
|
|
admin_user_ssh_public_key
|
A chave pública SSH da conta de usuário administrador. Default value: None
|
|
vnet_resourcegroup_name
|
O nome do grupo de recursos onde a rede virtual está localizada. Default value: None
|
|
vnet_name
|
O nome da rede virtual. Default value: None
|
|
subnet_name
|
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
|
Uma descrição opcional para o objeto de computação. Default value: None
|
|
assigned_user_object_id
|
O ID do objeto AAD do usuário atribuído (visualização). Default value: None
|
|
assigned_user_tenant_id
|
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
|
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
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 |
|---|---|