Compartir a través de


ComputeTarget Clase

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

Un destino de proceso es un recurso o entorno de proceso designado en el que se ejecuta el script de entrenamiento o se hospeda la implementación del servicio. 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.

Constructor

ComputeTarget(workspace, name)

Parámetros

Nombre Description
workspace
Requerido

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.

workspace
Requerido

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

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 un ComputeTargetException .

Métodos

attach

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

create

Aprovisione un objeto Compute especificando un tipo de proceso y una configuración relacionada.

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

delete

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

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

deserialize

Convertir un objeto JSON en un objeto Compute.

detach

Desasocie 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

Recupere el estado de aprovisionamiento actual del objeto Compute.

list

Enumere todos los objetos ComputeTarget del área de trabajo.

Devuelve una lista de objetos secundarios creados por instancias correspondientes al tipo específico de Proceso. Los objetos son elementos secundarios de ComputeTarget.

refresh_state

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

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

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

serialize

Convierta este objeto Compute en un diccionario serializado JSON.

wait_for_completion

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

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

attach

Adjunte un objeto Compute a un área de trabajo mediante 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 va a adjuntar el objeto Compute.

name
Requerido
str

Nombre que se va a asociar al objeto Compute.

attach_configuration
Requerido

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

Devoluciones

Tipo Description

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

Excepciones

Tipo Description

Comentarios

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

En el ejemplo siguiente se muestra cómo adjuntar una cuenta de ADLA a un área de trabajo mediante el attach_configuration método 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

Aprovisione un objeto Compute especificando un tipo de proceso y una configuración relacionada.

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

static create(workspace, name, provisioning_configuration)

Parámetros

Nombre Description
workspace
Requerido

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

name
Requerido
str

Nombre que se va a 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 provisioning_configuration parámetro 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

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

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

abstract delete()

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 una excepción y no se cambia nada.

deserialize

Convertir 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 va a convertir en un objeto Compute.

Devoluciones

Tipo Description

Representación compute del objeto JSON proporcionado.

Comentarios

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

detach

Desasocie 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()

get_status

Recupere el estado de aprovisionamiento actual del objeto Compute.

get_status()

Devoluciones

Tipo Description
str

Clase provisioning_state actual.

Comentarios

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

list

Enumere todos los objetos ComputeTarget del área de trabajo.

Devuelve una lista de objetos secundarios creados por instancias correspondientes al tipo específico de Proceso. Los objetos son elementos secundarios de ComputeTarget.

static list(workspace)

Parámetros

Nombre Description
workspace
Requerido

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

Devoluciones

Tipo Description

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

Excepciones

Tipo Description

refresh_state

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

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

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

abstract refresh_state()

serialize

Convierta este objeto Compute en un diccionario serializado JSON.

abstract serialize()

Devoluciones

Tipo Description

Representación JSON de este objeto Compute.

wait_for_completion

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

Este método devuelve un 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 eliminarla.

Valor predeterminado: False

Excepciones

Tipo Description