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?

Herencia

ABC

ComputeTarget

Constructor

ComputeTarget(workspace, name)

Parámetros

workspace

Workspace

Requerido

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

name

str

Requerido

Nombre del objeto Compute que se 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

workspace

Workspace

Requerido

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

name

str

Requerido

Nombre que se asociará al objeto Compute.

attach_configuration

ComputeTargetAttachConfiguration

Requerido

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

Devoluciones

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

Tipo de valor devuelto

ComputeTarget

Excepciones

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

workspace

Workspace

Requerido

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

name

str

Requerido

Nombre que se asociará al objeto Compute.

provisioning_configuration

ComputeTargetProvisioningConfiguration

Requerido

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

Devoluciones

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

Tipo de valor devuelto

ComputeTarget

Excepciones

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

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

workspace

Workspace

Requerido

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

object_dict

dict

Requerido

Objeto JSON que se convierte en un objeto Compute.

Devoluciones

Representación de Compute del objeto JSON proporcionado.

Tipo de valor devuelto

ComputeTarget

Excepciones

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

ComputeTargetException

get_status

Recupera el estado de aprovisionamiento actual del objeto Compute.

get_status()

Devoluciones

Objeto provisioning_state actual.

Tipo de valor devuelto

str

Excepciones

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

workspace

Workspace

Requerido

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

Devoluciones

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

Tipo de valor devuelto

list[ComputeTarget]

Excepciones

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

ComputeTargetException

serialize

Convierte este objeto Compute en un diccionario serializado JSON.

abstract serialize()

Devoluciones

Representación JSON de este objeto Compute.

Tipo de valor devuelto

dict

Excepciones

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

show_output

bool

valor predeterminado: False

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

is_delete_operation

bool

valor predeterminado: False

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

Excepciones

ComputeTargetException