ComputeTarget Clase

Referencia

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: ABC

ComputeTarget

Constructor

ComputeTarget(workspace, name)

Parámetros

Nombre	Description
workspace Requerido	Workspace 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	Workspace 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	Workspace 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	ComputeTargetAttachConfiguration Objeto ComputeTargetAttachConfiguration que se usa para determinar el tipo de objeto Compute que se va a asociar y cómo configurarlo.

Devoluciones

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

Excepciones

Tipo	Description
ComputeTargetException

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	Workspace 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	ComputeTargetProvisioningConfiguration Objeto ComputeTargetProvisioningConfiguration que se usa para determinar el tipo de objeto Compute que se va a aprovisionar y cómo configurarlo.

Devoluciones

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

Excepciones

Tipo	Description
ComputeTargetException

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
ComputeTargetException

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	Workspace Objeto de área de trabajo al que está asociado el objeto Compute.
object_dict Requerido	dict Objeto JSON que se convierte en un objeto Compute.

Devoluciones

Tipo	Description
ComputeTarget	Representación de Compute del objeto JSON proporcionado.

Excepciones

Tipo	Description
ComputeTargetException

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
ComputeTargetException

get_status

Recupera el estado de aprovisionamiento actual del objeto Compute.

get_status()

Devoluciones

Tipo	Description
str	Objeto `provisioning_state` actual.

Excepciones

Tipo	Description
ComputeTargetException

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	Workspace Objeto de área de trabajo que contiene los objetos que se enumerarán.

Devoluciones

Tipo	Description
list[ComputeTarget]	Lista de destinos de proceso dentro del área de trabajo.

Excepciones

Tipo	Description
ComputeTargetException

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
ComputeTargetException

serialize

Convierte este objeto Compute en un diccionario serializado JSON.

abstract serialize()

Devoluciones

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

Excepciones

Tipo	Description
ComputeTargetException

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	bool Indica si se debe proporcionar una salida más detallada. Valor predeterminado: False
is_delete_operation	bool Indica si la operación está pensada para eliminarse. Valor predeterminado: False

Excepciones

Tipo	Description
ComputeTargetException

Compartir a través de

ComputeTarget Clase

Constructor

Parámetros

Comentarios

Métodos

attach

Parámetros

Devoluciones

Excepciones

Comentarios

create

Parámetros

Devoluciones

Excepciones

Comentarios

delete

Excepciones

Comentarios

deserialize

Parámetros

Devoluciones

Excepciones

Comentarios

detach

Excepciones

get_status

Devoluciones

Excepciones

Comentarios

list

Parámetros

Devoluciones

Excepciones

refresh_state

Excepciones

serialize

Devoluciones

Excepciones

wait_for_completion

Parámetros

Excepciones

Comentarios

Recursos adicionales