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

ComputeTarget

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

ComputeTargetException

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

AmlCompute

Exceções

ComputeTargetException

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

ComputeTargetException

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

AmlComputeStatus

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

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

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

list

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

AmlComputeProvisioningConfiguration

Exceções

ComputeTargetException

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

dict

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

list

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

ComputeTargetException