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
|
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
|
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
|
O filtro é executado por "tag" ou {"tag": "value"} Valor padrão: None
|
|
properties
|
O filtro é executado por "property" ou {"property": "value"} Valor padrão: None
|
|
status
|
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
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
|
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:
Valor padrão: False
|
|
admin_user_ssh_public_key
|
A chave pública SSH da conta do usuário administrador. Valor padrão: None
|
|
vnet_resourcegroup_name
|
O nome do grupo de recursos em que a rede virtual está localizada. Valor padrão: None
|
|
vnet_name
|
O nome da rede virtual. Valor padrão: None
|
|
subnet_name
|
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
|
Uma descrição opcional para o objeto de computação. Valor padrão: None
|
|
assigned_user_object_id
|
A ID de objeto do AAD do usuário atribuído (versão prévia). Valor padrão: None
|
|
assigned_user_tenant_id
|
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
|
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
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 |
|---|---|