AmlCompute Classe

Gere um cálculo Azure Machine Learning em Azure Machine Learning.

Um Azure Machine Learning Compute (AmlCompute) é uma infraestrutura de computação gerida que lhe 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 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
<xref:str>
Necessário

O nome do objeto AmlCompute para recuperar.

Observações

No exemplo seguinte, é criado um alvo de computação persistente a AmlCompute provisionado. O provisioning_configuration parâmetro neste exemplo é do tipo , que é uma classe infantil de AmlComputeProvisioningConfiguration 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 AML recursos 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[<xref: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 de 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.

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
<xref: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

ComputeTargetExceptionEleva-se 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
<xref: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
<xref:str> ou <xref:dict>
valor predefinido: None

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

properties
<xref:str> ou <xref:dict>
valor predefinido: None

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

status
<xref: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.

list_quotas(workspace, location=None)

Parâmetros

workspace
Workspace
Necessário
location
<xref: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 AML recursos para um espaço de trabalho e subscrição.

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
<xref: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 AML recursos

Tipo de retorno

provisioning_configuration

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

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
<xref: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
<xref:str>
valor predefinido: dedicated

A prioridade VM, dedicada ou baixaprioridade.

min_nodes
<xref: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
<xref: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
<xref: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
<xref:str>
valor predefinido: None

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

admin_user_password
<xref:str>
valor predefinido: None

A palavra-passe da conta de utilizador do administrador.

admin_user_ssh_key
<xref:str>
valor predefinido: None

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

vnet_resourcegroup_name
<xref:str>
valor predefinido: None

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

vnet_name
<xref:str>
valor predefinido: None

O nome da rede virtual.

subnet_name
<xref:str>
valor predefinido: None

O nome da sub-rede dentro do VNet.

tags
<xref:dict>[<xref:str>, <xref:str>]
valor predefinido: None

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

description
<xref:str>
valor predefinido: None

Uma descrição para fornecer ao objeto computacional.

remote_login_port_public_access
<xref: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[<xref: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/ ']

location
<xref:str>
valor predefinido: None

Localização para provisão cluster em.

enable_node_public_ip
<xref: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[<xref: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 especificado

serialize

Converta este objeto AmlCompute num dicionário serializado JSON.

serialize()

Devoluções

A representação JSON deste objeto AmlCompute.

Tipo de retorno

<xref:dict>

supported_vmsizes

Listar os tamanhos de VM suportados numa região.

supported_vmsizes(workspace, location=None)

Parâmetros

workspace
Workspace
Necessário
location
<xref: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
<xref:int>
valor predefinido: None

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

max_nodes
<xref:int>
valor predefinido: None

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

idle_seconds_before_scaledown
<xref: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.

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

Parâmetros

workspace
Workspace
Necessário
vm_family
<xref:str>
Necessário

Nome da família VM

limit
<xref:int>
valor predefinido: None

A quota máxima permitida do recurso

location
<xref: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
<xref:bool>
valor predefinido: False

Boolean para fornecer uma saída mais verbosa.

min_node_count
<xref: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
<xref:int>
valor predefinido: 25

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

is_delete_operation
<xref:bool>
valor predefinido: False

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

Exceções