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
O objeto do espaço de trabalho que contém o 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
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.
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
O objeto do espaço de trabalho com o qual o objeto AmlCompute está associado.
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
Filtrar o gerador devolvido das operações pelo tipo fornecido. Consulte add_type_provider a criação de tipos de execução.
Filtro funciona por "propriedade" ou {"propriedade": "valor"}
Devoluções
um gerador de ~_restclient.models.RunDto
Tipo de retorno
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
- location
- str
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
- show_all
Especifica se são necessárias utilizações detalhadas dos recursos infantis. Incumprimentos para falso
- location
- str
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
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.
- min_nodes
- int
O número mínimo de nós a utilizar no aglomerado. Se não for especificado, o incumprimento é de 0.
- max_nodes
- int
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
O tempo de marcha lenta em segundos antes de escalonar o aglomerado. Se não for especificado, o incumprimento é de 1800.
- admin_username
- str
O nome da conta de utilizador do administrador que pode ser usada para SSH em nós.
- admin_user_password
- str
A palavra-passe da conta de utilizador do administrador.
- admin_user_ssh_key
- str
A chave pública SSH da conta de utilizador do administrador.
- vnet_resourcegroup_name
- str
O nome do grupo de recursos onde se encontra a rede virtual.
Um dicionário de etiquetas de valor chave para fornecer ao objeto computacional.
- remote_login_port_public_access
- str
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
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.
Lista de identificações de recursos para a identidade atribuída pelo utilizador. Por exemplo, ['/subscrições///grupos de recursos//fornecedores/Microsoft.ManagedIdentity/userAssignedIdentities/']
- enable_node_public_ip
- bool
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
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
- location
- str
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
- idle_seconds_before_scaledown
- int
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
- location
- str
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
- min_node_count
- int
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
A duração em minutos a aguardar antes de considerar o provisionamento falhou.
Exceções
Comentários
Submeter e ver comentários