AmlCompute Clase

Administra un proceso de Azure Machine Learning en Azure Machine Learning.

Un proceso de Azure Machine Learning (AmlCompute) es una infraestructura de proceso administrada que permite crear fácilmente un proceso de un solo nodo o de varios nodos. El proceso se crea dentro de la región del área de trabajo como un recurso que se puede compartir con otros usuarios. Para más información, consulte ¿Qué son los destinos de proceso en Azure Machine Learning?

Constructor ComputeTarget de clase.

Recupere una representación en la nube de un objeto Compute asociado al área de trabajo proporcionada. Devuelve una instancia de una clase secundaria correspondiente al tipo específico del objeto Compute recuperado.

Constructor

AmlCompute(workspace, name)

Parámetros

Nombre	Description
workspace Requerido	Workspace Objeto de área de trabajo que contiene el objeto AmlCompute que se va a recuperar.
name Requerido	str Nombre del objeto AmlCompute que se va a recuperar.
workspace Requerido	Workspace Objeto de área de trabajo que contiene el objeto Compute que se va a recuperar.
name Requerido	str Nombre del objeto Compute que se va a recuperar.

Comentarios

En el ejemplo siguiente, se crea un destino de proceso persistente aprovisionado por AmlCompute . El provisioning_configuration parámetro de este ejemplo es de tipo AmlComputeProvisioningConfiguration, que es una clase secundaria 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)

El ejemplo completo está disponible en https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-amlcompute/train-on-amlcompute.ipynb

Métodos

add_identity	Agregue el tipo de identidad o los identificadores de identidad para este destino AmlCompute.
delete	Quite el objeto AmlCompute de su área de trabajo asociada.
deserialize	Convierta un objeto JSON en un objeto AmlCompute.
detach	No se admite la desasociación para el objeto AmlCompute. En su lugar, use delete.
get	Devuelve el objeto de proceso.
get_active_runs	Devuelve un generador de las ejecuciones para este proceso.
get_status	Recupere el estado detallado actual del clúster de AmlCompute.
list_nodes	Obtenga los detalles (por ejemplo, dirección IP, puerto, etc.) de todos los nodos de proceso del destino de proceso.
list_quotas	Obtenga las cuotas del área de trabajo asignadas actualmente en función de VMFamily para el área de trabajo y la suscripción especificadas.
list_usages	Obtenga la información de uso actual, así como los límites de los recursos de AML para el área de trabajo y la suscripción dadas.
provisioning_configuration	Cree un objeto de configuración para aprovisionar un destino AmlCompute.
refresh_state	Realice una actualización local de las propiedades del objeto . Este método actualiza las propiedades en función del estado actual del objeto de nube correspondiente. Esto se usa principalmente para el sondeo manual del estado de proceso.
remove_identity	Quite la identidad del proceso.
serialize	Convierta este objeto AmlCompute en un diccionario serializado JSON.
supported_vmsizes	Enumere los tamaños de máquina virtual admitidos en una región.
update	Actualice para ScaleSettings este destino AmlCompute.
update_quotas	Actualice la cuota de una familia de máquinas virtuales en el área de trabajo.
wait_for_completion	Espere a que el clúster de AmlCompute finalice el aprovisionamiento. Esto se puede configurar para esperar un número mínimo de nodos y para que se espere un tiempo de espera después de un período de tiempo establecido.

add_identity

Agregue el tipo de identidad o los identificadores de identidad para este destino AmlCompute.

add_identity(identity_type, identity_id=None)

Parámetros

Nombre	Description
identity_type Requerido	string Los valores posibles son: SystemAssigned: identidad asignada por el sistema UserAssigned: identidad asignada por el usuario. Requiere que se establezca el identificador de identidad.
identity_id	list[str] Lista de identificadores de recursos para la identidad asignada por el usuario. Eg. ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity /userAssignedIdentities/'] Valor predeterminado: None

Comentarios

identity_id solo se debe especificar cuando identity_type == UserAssigned

delete

Quite el objeto AmlCompute de su área de trabajo asociada.

delete()

Excepciones

Tipo	Description
ComputeTargetException

Comentarios

Si este objeto se creó a través de Azure Machine Learning, también se eliminarán los objetos basados en la nube correspondientes. Si este objeto se creó externamente y solo se adjuntó al área de trabajo, este método genera un ComputeTargetException y no se cambia nada.

deserialize

Convierta un objeto JSON en un objeto AmlCompute.

static deserialize(workspace, object_dict)

Parámetros

Nombre	Description
workspace Requerido	Workspace Objeto de área de trabajo al que está asociado el objeto AmlCompute.
object_dict Requerido	dict Objeto JSON que se va a convertir en un objeto AmlCompute.

Devoluciones

Tipo	Description
AmlCompute	Representación AmlCompute del objeto JSON proporcionado.

Excepciones

Tipo	Description
ComputeTargetException

Comentarios

Genera un ComputeTargetException si el área de trabajo proporcionada no es el área de trabajo a la que está asociado el proceso.

detach

No se admite la desasociación para el objeto AmlCompute. En su lugar, use delete.

detach()

Excepciones

Tipo	Description
ComputeTargetException

get

Devuelve el objeto de proceso.

get()

get_active_runs

Devuelve un generador de las ejecuciones para este proceso.

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

Parámetros

Nombre	Description
type	str Filtre el generador devuelto de ejecuciones por el tipo proporcionado. Consulte add_type_provider para crear tipos de ejecución. Valor predeterminado: None
tags	str o dict El filtro se ejecuta por "tag" o {"tag": "value"} Valor predeterminado: None
properties	str o dict El filtro se ejecuta por "property" o {"property": "value"} Valor predeterminado: None
status	str Estado de ejecución: "En ejecución" o "En cola" Valor predeterminado: None

Devoluciones

Tipo	Description
<xref:builtin.generator>	generador de ~_restclient.models.RunDto

get_status

Recupere el estado detallado actual del clúster de AmlCompute.

get_status()

Devoluciones

Tipo	Description
AmlComputeStatus	Objeto de estado detallado para el clúster

list_nodes

Obtenga los detalles (por ejemplo, dirección IP, puerto, etc.) de todos los nodos de proceso del destino de proceso.

list_nodes()

Devoluciones

Tipo	Description
list	Los detalles de todos los nodos de proceso del destino de proceso.

list_quotas

Obtenga las cuotas del área de trabajo asignadas actualmente en función de VMFamily para el área de trabajo y la suscripción especificadas.

static list_quotas(workspace, location=None)

Parámetros

Nombre	Description
workspace Requerido	Workspace
location	str Ubicación de las cuotas. Si no se especifica, el valor predeterminado será la ubicación del área de trabajo. Valor predeterminado: None

Devoluciones

Tipo	Description
list	Lista de cuotas de área de trabajo asignadas actualmente basadas en VMFamily

list_usages

Obtenga la información de uso actual, así como los límites de los recursos de AML para el área de trabajo y la suscripción dadas.

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

Parámetros

Nombre	Description
workspace Requerido	Workspace
show_all	Especifica si se requieren usos detallados de los recursos secundarios. El valor predeterminado es False. Valor predeterminado: False
location	str Ubicación de los recursos. Si no se especifica, el valor predeterminado será la ubicación del área de trabajo. Valor predeterminado: None

Devoluciones

Tipo	Description
list	Lista de información de uso actual, así como límites para los recursos de AML

provisioning_configuration

Cree un objeto de configuración para aprovisionar un destino 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

Nombre	Description
vm_size Requerido	str Tamaño de las máquinas virtuales del agente. Puede encontrar más detalles aquí: https://aka.ms/azureml-vm-details. Tenga en cuenta que no todos los tamaños están disponibles en todas las regiones, como se detalla en el vínculo anterior. Si no se especifica, el valor predeterminado es Standard_NC6.
vm_priority	str Prioridad de máquina virtual, prioridad dedicada o bajaprioridad. Valor predeterminado: dedicated
min_nodes	int Número mínimo de nodos que se van a usar en el clúster. Si no se especifica, el valor predeterminado es 0. Valor predeterminado: 0
max_nodes	int Número máximo de nodos que se van a usar en el clúster. Si no se especifica, el valor predeterminado es 4. Valor predeterminado: None
idle_seconds_before_scaledown	int Tiempo de inactividad del nodo en segundos antes de reducir verticalmente el clúster. Si no se especifica, el valor predeterminado es 1800. Valor predeterminado: 1800
admin_username	str Nombre de la cuenta de usuario de administrador que se puede usar para SSH en nodos. Valor predeterminado: None
admin_user_password	str Contraseña de la cuenta de usuario administrador. Valor predeterminado: None
admin_user_ssh_key	str Clave pública SSH de la cuenta de usuario administrador. Valor predeterminado: None
vnet_resourcegroup_name	str Nombre del grupo de recursos donde se encuentra la red virtual. Valor predeterminado: None
vnet_name	str El nombre de la red virtual. Valor predeterminado: None
subnet_name	str Nombre de la subred dentro de la red virtual. Valor predeterminado: None
tags	dict[str, str] Diccionario de etiquetas de valor de clave que se van a proporcionar al objeto de proceso. Valor predeterminado: None
description	str Descripción que se va a proporcionar al objeto de proceso. Valor predeterminado: None
remote_login_port_public_access	str Estado del puerto SSH público. Los valores posibles son: Deshabilitado: indica que el puerto ssh público está cerrado en todos los nodos del clúster. Habilitado: indica que el puerto ssh público está abierto en todos los nodos del clúster. NotSpecified: indica que el puerto ssh público está cerrado en todos los nodos del clúster si se define la red virtual; de lo contrario, se abren todos los nodos públicos. Puede ser este valor predeterminado solo durante el tiempo de creación del clúster. Después de la creación, se habilitará o deshabilitará. Valor predeterminado: NotSpecified
identity_type	string Los valores posibles son: SystemAssigned: identidad asignada por el sistema UserAssigned: identidad asignada por el usuario. Requiere que se establezca el identificador de identidad. Valor predeterminado: None
identity_id	list[str] Lista de identificadores de recursos para la identidad asignada por el usuario. Eg. ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity/userAssignedIdentities/'] Valor predeterminado: None
location	str Ubicación en la que se aprovisiona el clúster. Valor predeterminado: None
enable_node_public_ip	bool Habilite la dirección IP pública del nodo. Los valores posibles son: True: habilite la dirección IP pública del nodo. False: deshabilita la dirección IP pública del nodo. NotSpecified: habilite la dirección IP pública del nodo. Valor predeterminado: True

Devoluciones

Tipo	Description
AmlComputeProvisioningConfiguration	Objeto de configuración que se va a usar al crear un objeto Compute.

Excepciones

Tipo	Description
ComputeTargetException

refresh_state

Realice una actualización local de las propiedades del objeto .

Este método actualiza las propiedades en función del estado actual del objeto de nube correspondiente. Esto se usa principalmente para el sondeo manual del estado de proceso.

refresh_state()

remove_identity

Quite la identidad del proceso.

remove_identity(identity_id=None)

Parámetros

Nombre	Description
identity_id	list[str] Identidades asignadas por el usuario Valor predeterminado: None

Comentarios

La identidad asignada por el sistema se quitará automáticamente si no se especifica identity_id

serialize

Convierta este objeto AmlCompute en un diccionario serializado JSON.

serialize()

Devoluciones

Tipo	Description
dict	Representación JSON de este objeto AmlCompute.

supported_vmsizes

Enumere los tamaños de máquina virtual admitidos en una región.

static supported_vmsizes(workspace, location=None)

Parámetros

Nombre	Description
workspace Requerido	Workspace
location	str Ubicación del clúster. Si no se especifica, el valor predeterminado será la ubicación del área de trabajo. Valor predeterminado: None

Devoluciones

Tipo	Description
list	Lista de tamaños de máquina virtual admitidos en una región con nombres de máquina virtual, VCPU y RAM.

update

Actualice para ScaleSettings este destino AmlCompute.

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

Parámetros

Nombre	Description
min_nodes	int Número mínimo de nodos que se van a usar en el clúster. Valor predeterminado: None
max_nodes	int Número máximo de nodos que se van a usar en el clúster. Valor predeterminado: None
idle_seconds_before_scaledown	int Tiempo de inactividad del nodo en segundos antes de reducir verticalmente el clúster. Valor predeterminado: None

update_quotas

Actualice la cuota de una familia de máquinas virtuales en el área de trabajo.

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

Parámetros

Nombre	Description
workspace Requerido	Workspace
vm_family Requerido	str Nombre de familia de máquina virtual
limit	int Cuota máxima permitida del recurso Valor predeterminado: None
location	str Ubicación de la cuota. Si no se especifica, el valor predeterminado será la ubicación del área de trabajo. Valor predeterminado: None

wait_for_completion

Espere a que el clúster de AmlCompute finalice el aprovisionamiento.

Esto se puede configurar para esperar un número mínimo de nodos y para que se espere un tiempo de espera después de un período de tiempo establecido.

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

Parámetros

Nombre	Description
show_output	bool Boolean para proporcionar una salida más detallada. Valor predeterminado: False
min_node_count	int Número mínimo de nodos que se esperarán antes de considerar que el aprovisionamiento se complete. Esto no tiene que ser igual al número mínimo de nodos con los que se aprovisionó el proceso, pero no debe ser mayor que eso. Valor predeterminado: None
timeout_in_minutes	int La duración en minutos que se debe esperar antes de considerar que se ha producido un error en el aprovisionamiento. Valor predeterminado: 25
is_delete_operation	bool Indica si la operación está pensada para eliminarla. Valor predeterminado: False

Excepciones

Tipo	Description
ComputeTargetException

Compartir a través de

AmlCompute Clase

Constructor

Parámetros

Comentarios

Métodos

add_identity

Parámetros

Comentarios

delete

Excepciones

Comentarios

deserialize

Parámetros

Devoluciones

Excepciones

Comentarios

detach

Excepciones

get

get_active_runs

Parámetros

Devoluciones

get_status

Devoluciones

list_nodes

Devoluciones

list_quotas

Parámetros

Devoluciones

list_usages

Parámetros

Devoluciones

provisioning_configuration

Parámetros

Devoluciones

Excepciones

refresh_state

remove_identity

Parámetros

Comentarios

serialize

Devoluciones

supported_vmsizes

Parámetros

Devoluciones

update

Parámetros

update_quotas

Parámetros

wait_for_completion

Parámetros

Excepciones

Comentarios