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
|
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
|
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
|
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
|
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 |
---|---|
Clase |
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 |
---|---|