AmlCompute Classe

Gere um computamento de Aprendizagem automática Azure em Azure Machine Learning.

A Azure Machine Learning Compute (AmlCompute) é uma infraestrutura de computação gerida que permite criar facilmente um único ou multi-nó compute. O cálculo é criado dentro da sua região do espaço de trabalho como um recurso que pode ser partilhado com outros utilizadores. Para obter mais informações, veja quais são os alvos de cálculo em Azure Machine Learning?

Herança
AmlCompute

Construtor

AmlCompute(workspace, name)

Parâmetros

workspace
Workspace
Necessário

O objeto do espaço de trabalho que contém o objeto AmlCompute para recuperar.

name
str
Necessário

O nome do objeto AmlCompute para recuperar.

Observações

No exemplo seguinte, é criado um alvo de computação persistente a provisionado AmlCompute . O provisioning_configuration parâmetro neste exemplo é do tipo AmlComputeProvisioningConfiguration, que é uma classe infantil de ComputeTargetProvisioningConfiguration.


   from azureml.core.compute import ComputeTarget, AmlCompute
   from azureml.core.compute_target import ComputeTargetException

   # Choose a name for your CPU cluster
   cpu_cluster_name = "cpu-cluster"

   # Verify that cluster does not exist already
   try:
       cpu_cluster = ComputeTarget(workspace=ws, name=cpu_cluster_name)
       print('Found existing cluster, use it.')
   except ComputeTargetException:
       compute_config = AmlCompute.provisioning_configuration(vm_size='STANDARD_D2_V2',
                                                              max_nodes=4)
       cpu_cluster = ComputeTarget.create(ws, cpu_cluster_name, compute_config)

   cpu_cluster.wait_for_completion(show_output=True)

A amostra completa está disponível a partir de https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-amlcompute/train-on-amlcompute.ipynb

Métodos

add_identity

Adicione identificação tipo de identidade e/ou identidade para este alvo AmlCompute.

delete

Retire o objeto AmlCompute do seu espaço de trabalho associado.

deserialize

Converta um objeto JSON num objeto AmlCompute.

detach

O desprendimento não é suportado para o objeto AmlCompute. Em vez disso, utilize delete.

get

Objeto computacional de retorno.

get_active_runs

Devolva um gerador das corridas para este cálculo.

get_status

Recupere o estado detalhado atual do cluster AmlCompute.

list_nodes

Obtenha os detalhes (por exemplo, endereço IP, porta, etc.) de todos os nós de computação no alvo do cálculo.

list_quotas

Obtenha as quotas de espaço de trabalho atualmente atribuídas com base na VMFamily para um espaço de trabalho e subscrição.

list_usages

Obtenha as informações de utilização atuais, bem como limites para os recursos AML para um espaço de trabalho e subscrição.

provisioning_configuration

Crie um objeto de configuração para o fornecimento de um alvo AmlCompute.

refresh_state

Efetue uma atualização in-place das propriedades do objeto.

Este método atualiza as propriedades com base no estado atual do objeto de nuvem correspondente. Isto é usado principalmente para sondagens manuais do estado computacional.

remove_identity

Remova a identidade no cálculo.

serialize

Converta este objeto AmlCompute num dicionário serializado JSON.

supported_vmsizes

Listar os tamanhos de VM suportados numa região.

update

Atualize o ScaleSettings alvo AmlCompute.

update_quotas

Quota de atualização para uma família VM no espaço de trabalho.

wait_for_completion

Aguarde que o cluster AmlCompute termine o provisionamento.

Isto pode ser configurado para esperar por um número mínimo de nós, e para o intervalo após um período de tempo definido.

add_identity

Adicione identificação tipo de identidade e/ou identidade para este alvo AmlCompute.

add_identity(identity_type, identity_id=None)

Parâmetros

identity_type
string
Necessário

Os valores possíveis são:

  • SistemaAssigned - Identidade atribuída ao sistema

  • UtilizadorAssigned - Identidade atribuída ao utilizador. Requer identificação de identidade para ser definida.

identity_id
list[str]
valor predefinido: None

Lista de identificações de recursos para a identidade atribuída pelo utilizador. Por exemplo, ['/subscrições///resourceGroups///providers/Microsoft.ManagedIdentity /userAssignedIdentities/']

Observações

identity_id só deve ser especificado quando identity_type == Utilizador Assintado

delete

Retire o objeto AmlCompute do seu espaço de trabalho associado.

delete()

Exceções

Observações

Se este objeto foi criado através do Azure Machine Learning, os objetos correspondentes baseados na nuvem também serão eliminados. Se este objeto foi criado externamente e apenas ligado ao espaço de trabalho, este método levanta um ComputeTargetException e nada é alterado.

deserialize

Converta um objeto JSON num objeto AmlCompute.

static deserialize(workspace, object_dict)

Parâmetros

workspace
Workspace
Necessário

O objeto do espaço de trabalho com o qual o objeto AmlCompute está associado.

object_dict
dict
Necessário

Um objeto JSON para converter num objeto AmlCompute.

Devoluções

A representação AmlCompute do objeto JSON fornecido.

Tipo de retorno

Exceções

Observações

Eleva-se ComputeTargetException a se o espaço de trabalho fornecido não é o espaço de trabalho a que o Compute está associado.

detach

O desprendimento não é suportado para o objeto AmlCompute. Em vez disso, utilize delete.

detach()

Exceções

get

Objeto computacional de retorno.

get()

get_active_runs

Devolva um gerador das corridas para este cálculo.

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

Parâmetros

type
str
valor predefinido: None

Filtrar o gerador devolvido das operações pelo tipo fornecido. Consulte add_type_provider a criação de tipos de execução.

tags
str ou dict
valor predefinido: None

O filtro funciona por "tag" ou {"tag": "valor"}

properties
str ou dict
valor predefinido: None

Filtro funciona por "propriedade" ou {"propriedade": "valor"}

status
str
valor predefinido: None

Estado de execução - ou "Running" ou "Queued"

Devoluções

um gerador de ~_restclient.models.RunDto

Tipo de retorno

<xref:builtin.generator>

get_status

Recupere o estado detalhado atual do cluster AmlCompute.

get_status()

Devoluções

Um objeto de estado detalhado para o cluster

Tipo de retorno

list_nodes

Obtenha os detalhes (por exemplo, endereço IP, porta, etc.) de todos os nós de computação no alvo do cálculo.

list_nodes()

Devoluções

Os detalhes de todos os nós de computação no alvo do cálculo.

Tipo de retorno

list_quotas

Obtenha as quotas de espaço de trabalho atualmente atribuídas com base na VMFamily para um espaço de trabalho e subscrição.

static list_quotas(workspace, location=None)

Parâmetros

workspace
Workspace
Necessário
location
str
valor predefinido: None

A localização das quotas. Se não for especificado, o local do espaço de trabalho será padrão.

Devoluções

Lista de quotas de espaço de trabalho atualmente atribuídas com base na VMFamily

Tipo de retorno

list_usages

Obtenha as informações de utilização atuais, bem como limites para os recursos AML para um espaço de trabalho e subscrição.

static list_usages(workspace, show_all=False, location=None)

Parâmetros

workspace
Workspace
Necessário
show_all
valor predefinido: False

Especifica se são necessárias utilizações detalhadas dos recursos infantis. Incumprimentos para falso

location
str
valor predefinido: None

A localização dos recursos. Se não for especificado, o local do espaço de trabalho será padrão.

Devoluções

Lista de informações de utilização atuais, bem como limites para os recursos AML

Tipo de retorno

provisioning_configuration

Crie um objeto de configuração para o fornecimento de um alvo AmlCompute.

static provisioning_configuration(vm_size='', vm_priority='dedicated', min_nodes=0, max_nodes=None, idle_seconds_before_scaledown=1800, admin_username=None, admin_user_password=None, admin_user_ssh_key=None, vnet_resourcegroup_name=None, vnet_name=None, subnet_name=None, tags=None, description=None, remote_login_port_public_access='NotSpecified', identity_type=None, identity_id=None, location=None, enable_node_public_ip=True)

Parâmetros

vm_size
str
Necessário

Do tamanho do agente VMs. Mais detalhes podem ser encontrados aqui: https://aka.ms/azureml-vm-details. Note que nem todos os tamanhos estão disponíveis em todas as regiões, conforme detalhado no link anterior. Se não for especificado, os predefinidos Standard_NC6.

vm_priority
str
valor predefinido: dedicated

A prioridade VM, dedicada ou baixaprioridade.

min_nodes
int
valor predefinido: 0

O número mínimo de nós a utilizar no aglomerado. Se não for especificado, o incumprimento é de 0.

max_nodes
int
valor predefinido: None

O número máximo de nós a utilizar no cluster. Se não for especificado, o incumprimento é de 4.

idle_seconds_before_scaledown
int
valor predefinido: 1800

O tempo de marcha lenta em segundos antes de escalonar o aglomerado. Se não for especificado, o incumprimento é de 1800.

admin_username
str
valor predefinido: None

O nome da conta de utilizador do administrador que pode ser usada para SSH em nós.

admin_user_password
str
valor predefinido: None

A palavra-passe da conta de utilizador do administrador.

admin_user_ssh_key
str
valor predefinido: None

A chave pública SSH da conta de utilizador do administrador.

vnet_resourcegroup_name
str
valor predefinido: None

O nome do grupo de recursos onde se encontra a rede virtual.

vnet_name
str
valor predefinido: None

O nome da rede virtual.

subnet_name
str
valor predefinido: None

O nome da sub-rede dentro do VNet.

tags
dict[str, str]
valor predefinido: None

Um dicionário de etiquetas de valor chave para fornecer ao objeto computacional.

description
str
valor predefinido: None

Uma descrição para fornecer ao objeto computacional.

remote_login_port_public_access
str
valor predefinido: NotSpecified

Estado do porto público de SSH. Os valores possíveis são:

  • Desativado - Indica que a porta pública está fechada em todos os nós do aglomerado.

  • Ativado - Indica que a porta pública está aberta em todos os nós do cluster.

  • NotSpecified - Indica que a porta ssh pública está fechada em todos os nós do cluster se o VNet estiver definido, caso o VNet esteja aberto a todos os nós públicos. Pode ser este valor padrão apenas durante o tempo de criação do cluster. Após a criação, será ativado ou desativado.

identity_type
string
valor predefinido: None

Os valores possíveis são:

  • SistemaAssigned - Identidade atribuída ao sistema

  • UtilizadorAssigned - Identidade atribuída ao utilizador. Requer identificação de identidade para ser definida.

identity_id
list[str]
valor predefinido: None

Lista de identificações de recursos para a identidade atribuída pelo utilizador. Por exemplo, ['/subscrições///grupos de recursos//fornecedores/Microsoft.ManagedIdentity/userAssignedIdentities/']

location
str
valor predefinido: None

Localização para provisão cluster em.

enable_node_public_ip
bool
valor predefinido: True

Ativar o nó IP público. Os valores possíveis são:

  • Verdade - Ativar o nó IP público.

  • Falso - Desativar o nó público IP.

  • NotSpecified - Ativar o nó IP público.

Devoluções

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

Tipo de retorno

Exceções

refresh_state

Efetue uma atualização in-place das propriedades do objeto.

Este método atualiza as propriedades com base no estado atual do objeto de nuvem correspondente. Isto é usado principalmente para sondagens manuais do estado computacional.

refresh_state()

remove_identity

Remova a identidade no cálculo.

remove_identity(identity_id=None)

Parâmetros

identity_id
list[str]
valor predefinido: None

Identidades atribuídas pelo utilizador

Observações

A identidade atribuída ao sistema será removida automaticamente se identity_id não for especificada

serialize

Converta este objeto AmlCompute num dicionário serializado JSON.

serialize()

Devoluções

A representação JSON deste objeto AmlCompute.

Tipo de retorno

supported_vmsizes

Listar os tamanhos de VM suportados numa região.

static supported_vmsizes(workspace, location=None)

Parâmetros

workspace
Workspace
Necessário
location
str
valor predefinido: None

A localização do aglomerado. Se não for especificado, o local do espaço de trabalho será padrão.

Devoluções

Uma lista de tamanhos VM suportados numa região com nomes dos VM, VCPUs e RAM.

Tipo de retorno

update

Atualize o ScaleSettings alvo AmlCompute.

update(min_nodes=None, max_nodes=None, idle_seconds_before_scaledown=None)

Parâmetros

min_nodes
int
valor predefinido: None

O número mínimo de nós a utilizar no aglomerado.

max_nodes
int
valor predefinido: None

O número máximo de nós a utilizar no cluster.

idle_seconds_before_scaledown
int
valor predefinido: None

O nó inativo em segundos antes de escalonar o aglomerado.

update_quotas

Quota de atualização para uma família VM no espaço de trabalho.

static update_quotas(workspace, vm_family, limit=None, location=None)

Parâmetros

workspace
Workspace
Necessário
vm_family
str
Necessário

Nome da família VM

limit
int
valor predefinido: None

A quota máxima permitida do recurso

location
str
valor predefinido: None

A localização da cota. Se não for especificado, o local do espaço de trabalho será padrão.

wait_for_completion

Aguarde que o cluster AmlCompute termine o provisionamento.

Isto pode ser configurado para esperar por um número mínimo de nós, e para o intervalo após um período de tempo definido.

wait_for_completion(show_output=False, min_node_count=None, timeout_in_minutes=25, is_delete_operation=False)

Parâmetros

show_output
bool
valor predefinido: False

Boolean para fornecer uma saída mais verbosa.

min_node_count
int
valor predefinido: None

Número mínimo de nós a aguardar antes de considerar o provisionamento para ser completo. Isto não tem de igualar o número mínimo de nós com que o cálculo foi a provisionado, no entanto não deve ser maior do que isso.

timeout_in_minutes
int
valor predefinido: 25

A duração em minutos a aguardar antes de considerar o provisionamento falhou.

is_delete_operation
bool
valor predefinido: False

Indica se a operação destina-se a apagar.

Exceções