ComputeTarget Clase

Clase primaria abstracta para todos los destinos de proceso administrados por Azure Machine Learning.

Un destino de proceso es un entorno o recurso de proceso en el que se ejecuta el script de entrenamiento o se hospeda la implementación del servicio web. Esta ubicación puede ser su equipo local o un recurso de proceso en la nube. 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.

Herencia
ComputeTarget

Constructor

ComputeTarget(workspace, name)

Parámetros

Nombre Description
workspace
Requerido

Objeto de área de trabajo que contiene el objeto Compute que se recuperará.

name
Requerido
str

Nombre del objeto Compute que se recuperará.

workspace
Requerido

Objeto de área de trabajo que contiene el objeto Compute que se recuperará.

name
Requerido
str

Nombre del objeto Compute que se va a recuperar.

Comentarios

Use el constructor ComputeTarget para recuperar la representación en la nube de un objeto Compute asociado al área de trabajo proporcionada. El constructor devuelve una instancia de una clase secundaria correspondiente al tipo específico del objeto Compute recuperado. Si no se encuentra el objeto Compute, se genera ComputeTargetException.

Métodos

attach

Asocia un objeto Compute a un área de trabajo con el nombre y la información de configuración especificados.

create

Aprovisiona un objeto Compute mediante la especificación de un tipo de proceso y una configuración relacionada.

Este método crea un nuevo destino de proceso en lugar de asociar uno existente.

delete

Quita el objeto Compute de su área de trabajo asociada.

Este método abstracto se implementa mediante clases secundarias de ComputeTarget.

deserialize

Convierte un objeto JSON en un objeto Compute.

detach

Desasocia el objeto Compute de su área de trabajo asociada.

Este método abstracto se implementa mediante clases secundarias de ComputeTarget. Los objetos en la nube subyacentes no se eliminan, solo se quitan sus asociaciones.

get_status

Recupera el estado de aprovisionamiento actual del objeto Compute.

list

Enumera todos los objetos ComputeTarget dentro del área de trabajo.

Devuelve una lista de objetos secundarios con instancias correspondientes al tipo específico de Compute. Los objetos son secundarios de ComputeTarget.

refresh_state

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

Actualiza las propiedades en función del estado actual del objeto de nube correspondiente. Es útil para el sondeo manual del estado de proceso.

Este método abstracto se implementa mediante clases secundarias de ComputeTarget.

serialize

Convierte este objeto Compute en un diccionario serializado JSON.

wait_for_completion

Espera a que finalice la operación de aprovisionamiento actual en el clúster.

Este método devuelve ComputeTargetException si hay un problema al sondear el objeto de proceso.

attach

Asocia un objeto Compute a un área de trabajo con el nombre y la información de configuración especificados.

static attach(workspace, name, attach_configuration)

Parámetros

Nombre Description
workspace
Requerido

Objeto de área de trabajo al que se asociará el objeto Compute.

name
Requerido
str

Nombre que se asociará al objeto Compute.

attach_configuration
Requerido

Objeto ComputeTargetAttachConfiguration que se usa para determinar el tipo de objeto Compute que se va a asociar y cómo configurarlo.

Devoluciones

Tipo Description

Instancia de un elemento secundario de ComputeTarget correspondiente al tipo de objeto asociado.

Excepciones

Tipo Description

Comentarios

El tipo de objeto que se va a pasar al parámetro attach_configuration es un objeto ComputeTargetAttachConfiguration creado mediante la función attach_configuration en cualquiera de las clases secundarias de ComputeTarget.

En el ejemplo siguiente se muestra cómo asociar una cuenta de ADLA a un área de trabajo mediante el método attach_configuration de AdlaCompute.


   adla_compute_name = 'testadl' # Name to associate with new compute in workspace

   # ADLA account details needed to attach as compute to workspace
   adla_account_name = "<adla_account_name>" # Name of the Azure Data Lake Analytics account
   adla_resource_group = "<adla_resource_group>" # Name of the resource group which contains this account

   try:
       # check if already attached
       adla_compute = AdlaCompute(ws, adla_compute_name)
   except ComputeTargetException:
       print('attaching adla compute...')
       attach_config = AdlaCompute.attach_configuration(resource_group=adla_resource_group, account_name=adla_account_name)
       adla_compute = ComputeTarget.attach(ws, adla_compute_name, attach_config)
       adla_compute.wait_for_completion()

   print("Using ADLA compute:{}".format(adla_compute.cluster_resource_id))
   print("Provisioning state:{}".format(adla_compute.provisioning_state))
   print("Provisioning errors:{}".format(adla_compute.provisioning_errors))

El ejemplo completo está disponible en https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/machine-learning-pipelines/intro-to-pipelines/aml-pipelines-use-adla-as-compute-target.ipynb.

create

Aprovisiona un objeto Compute mediante la especificación de un tipo de proceso y una configuración relacionada.

Este método crea un nuevo destino de proceso en lugar de asociar uno existente.

static create(workspace, name, provisioning_configuration)

Parámetros

Nombre Description
workspace
Requerido

Objeto de área de trabajo en el que se creará el objeto Compute.

name
Requerido
str

Nombre que se asociará al objeto Compute.

provisioning_configuration
Requerido

Objeto ComputeTargetProvisioningConfiguration que se usa para determinar el tipo de objeto Compute que se va a aprovisionar y cómo configurarlo.

Devoluciones

Tipo Description

Instancia de un elemento secundario de ComputeTarget correspondiente al tipo de objeto aprovisionado.

Excepciones

Tipo Description

Comentarios

El tipo de objeto aprovisionado viene determinado por la configuración de aprovisionamiento proporcionada.

En el ejemplo siguiente, se crea un destino de proceso persistente aprovisionado por AmlCompute. El parámetro provisioning_configuration de este ejemplo es de tipo AmlComputeProvisioningConfiguration.


   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.

delete

Quita el objeto Compute de su área de trabajo asociada.

Este método abstracto se implementa mediante clases secundarias de ComputeTarget.

abstract delete()

Excepciones

Tipo Description

Comentarios

Si este objeto se creó mediante Azure Machine Learning, también se eliminarán los objetos basados en la nube correspondientes. Si este objeto se creó externamente y solo está asociado al área de trabajo, este método genera una excepción y no cambia nada.

deserialize

Convierte un objeto JSON en un objeto Compute.

abstract static deserialize(workspace, object_dict)

Parámetros

Nombre Description
workspace
Requerido

Objeto de área de trabajo al que está asociado el objeto Compute.

object_dict
Requerido

Objeto JSON que se convierte en un objeto Compute.

Devoluciones

Tipo Description

Representación de Compute del objeto JSON proporcionado.

Excepciones

Tipo Description

Comentarios

Genera una excepción ComputeTargetException si el área de trabajo proporcionada no es el área de trabajo a la que está asociado el proceso.

detach

Desasocia el objeto Compute de su área de trabajo asociada.

Este método abstracto se implementa mediante clases secundarias de ComputeTarget. Los objetos en la nube subyacentes no se eliminan, solo se quitan sus asociaciones.

abstract detach()

Excepciones

Tipo Description

get_status

Recupera el estado de aprovisionamiento actual del objeto Compute.

get_status()

Devoluciones

Tipo Description
str

Objeto provisioning_state actual.

Excepciones

Tipo Description

Comentarios

Los valores devueltos se muestran en la referencia de la API de REST de Azure para ProvisioningState.

list

Enumera todos los objetos ComputeTarget dentro del área de trabajo.

Devuelve una lista de objetos secundarios con instancias correspondientes al tipo específico de Compute. Los objetos son secundarios de ComputeTarget.

static list(workspace)

Parámetros

Nombre Description
workspace
Requerido

Objeto de área de trabajo que contiene los objetos que se enumerarán.

Devoluciones

Tipo Description

Lista de destinos de proceso dentro del área de trabajo.

Excepciones

Tipo Description

refresh_state

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

Actualiza las propiedades en función del estado actual del objeto de nube correspondiente. Es útil para el sondeo manual del estado de proceso.

Este método abstracto se implementa mediante clases secundarias de ComputeTarget.

abstract refresh_state()

Excepciones

Tipo Description

serialize

Convierte este objeto Compute en un diccionario serializado JSON.

abstract serialize()

Devoluciones

Tipo Description

Representación JSON de este objeto Compute.

Excepciones

Tipo Description

wait_for_completion

Espera a que finalice la operación de aprovisionamiento actual en el clúster.

Este método devuelve ComputeTargetException si hay un problema al sondear el objeto de proceso.

wait_for_completion(show_output=False, is_delete_operation=False)

Parámetros

Nombre Description
show_output

Indica si se debe proporcionar una salida más detallada.

Valor predeterminado: False
is_delete_operation

Indica si la operación está pensada para eliminarse.

Valor predeterminado: False

Excepciones

Tipo Description