Compartir a través de


ComputeInstance Clase

Administra un entorno de desarrollo de ML optimizado y basado en la nube en Azure Machine Learning.

Una instancia de proceso de Azure Machine Learning es un entorno de desarrollo totalmente configurado y administrado en la nube que está optimizado para flujos de trabajo de desarrollo de aprendizaje automático. ComputeInstance se usa normalmente para crear un entorno de desarrollo o como destino de proceso para el entrenamiento y la inferencia para el desarrollo y las pruebas. Con ComputeInstance puede crear, entrenar e implementar modelos en una experiencia de cuaderno totalmente integrada en el área de trabajo. Para obtener más información, vea ¿Qué es una instancia de proceso de 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

ComputeInstance(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.

Métodos

delete

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

deserialize

Convierta un objeto JSON en un objeto ComputeInstance.

Esto produce un error si el área de trabajo proporcionada no es el área de trabajo a la que está asociada ComputeInstance.

detach

No se admite la desasociación para el objeto ComputeInstance. En su lugar, use delete.

get

Devuelve el objeto ComputeInstance.

get_active_runs

Devuelve un generador de las ejecuciones para este proceso.

get_docs_url

Dirección URL a la documentación de esta clase.

get_status

Recupere el estado detallado actual de ComputeInstance.

provisioning_configuration

Cree un objeto de configuración para aprovisionar un destino ComputeInstance.

refresh_state

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

Este método actualiza las propiedades en función del estado actual del objeto de nube correspondiente. Esto es principalmente útil para el sondeo manual del estado de proceso.

restart

Reinicie ComputeInstance.

serialize

Convierta este objeto ComputeInstance en un diccionario serializado JSON.

start

Inicie ComputeInstance.

stop

Detenga ComputeInstance.

supported_vmsizes

Enumere los tamaños de máquina virtual admitidos en una región.

update_sso_settings

Actualice la configuración de inicio de sesión único de la instancia de proceso.

wait_for_completion

Espere a que ComputeInstance finalice el aprovisionamiento.

delete

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

delete(wait_for_completion=False, show_output=False)

Parámetros

Nombre Description
wait_for_completion
Valor predeterminado: False
show_output
Valor predeterminado: False

Excepciones

Tipo Description

Comentarios

Si este objeto se creó a través de Azure ML, 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, generará una excepción y no se cambiará nada.

deserialize

Convierta un objeto JSON en un objeto ComputeInstance.

Esto produce un error si el área de trabajo proporcionada no es el área de trabajo a la que está asociada ComputeInstance.

static deserialize(workspace, object_dict)

Parámetros

Nombre Description
workspace
Requerido

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

object_dict
Requerido

Objeto JSON que se va a convertir en un objeto ComputeInstance.

Devoluciones

Tipo Description

Representación ComputeInstance del objeto JSON proporcionado.

Excepciones

Tipo Description

detach

No se admite la desasociación para el objeto ComputeInstance. En su lugar, use delete.

detach()

Excepciones

Tipo Description

La operación no se supprote.

get

Devuelve el objeto ComputeInstance.

get()

Devoluciones

Tipo Description

Representación ComputeInstance del objeto JSON proporcionado.

Excepciones

Tipo Description

get_active_runs

Devuelve un generador de las ejecuciones para este proceso.

get_active_runs(type=None, tags=None, properties=None, status=None)

Parámetros

Nombre Description
type
str

Filtre el generador devuelto de ejecuciones por el tipo proporcionado. Consulte add_type_provider para crear tipos de ejecución.

Valor predeterminado: None
tags
str o dict

El filtro se ejecuta por "tag" o {"tag": "value"}

Valor predeterminado: None
properties
str o dict

El filtro se ejecuta por "property" o {"property": "value"}

Valor predeterminado: None
status
str

Estado de ejecución, puede ser "En ejecución" o "En cola".

Valor predeterminado: None

Devoluciones

Tipo Description
<xref:builtin.generator>

Generador de azureml._restclient.models.RunDto

get_docs_url

Dirección URL a la documentación de esta clase.

get_docs_url()

Devoluciones

Tipo Description
str

URL

get_status

Recupere el estado detallado actual de ComputeInstance.

get_status()

Devoluciones

Tipo Description

Objeto de estado detallado para el proceso

provisioning_configuration

Cree un objeto de configuración para aprovisionar un destino ComputeInstance.

static provisioning_configuration(vm_size='', ssh_public_access=False, admin_user_ssh_public_key=None, vnet_resourcegroup_name=None, vnet_name=None, subnet_name=None, tags=None, description=None, assigned_user_object_id=None, assigned_user_tenant_id=None)

Parámetros

Nombre Description
vm_size
Requerido
str

Tamaño de las máquinas virtuales del agente. Puede encontrar más detalles aquí: https://aka.ms/azureml-vm-details. Tenga en cuenta que no todos los tamaños están disponibles en todas las regiones, como se detalla en el vínculo anterior. El valor predeterminado es Standard_NC6.

ssh_public_access

Indica el estado del puerto SSH público. Los valores posibles son:

  • False: el puerto SSH público está cerrado.
  • True: el puerto SSH público está abierto.
Valor predeterminado: False
admin_user_ssh_public_key
str

Clave pública SSH de la cuenta de usuario administrador.

Valor predeterminado: None
vnet_resourcegroup_name
str

Nombre del grupo de recursos donde se encuentra la red virtual.

Valor predeterminado: None
vnet_name
str

El nombre de la red virtual.

Valor predeterminado: None
subnet_name
str

Nombre de la subred dentro de la red virtual.

Valor predeterminado: None
tags

Diccionario opcional de etiquetas de valor de clave que se van a asociar al objeto de proceso.

Valor predeterminado: None
description
str

Descripción opcional del objeto de proceso.

Valor predeterminado: None
assigned_user_object_id
str

Identificador de objeto de AAD del usuario asignado (versión preliminar).

Valor predeterminado: None
assigned_user_tenant_id
str

Identificador de inquilino de AAD del usuario asignado (versión preliminar).

Valor predeterminado: None

Devoluciones

Tipo Description

Objeto de configuración que se va a usar al crear un objeto Compute.

Excepciones

Tipo Description

refresh_state

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

Este método actualiza las propiedades en función del estado actual del objeto de nube correspondiente. Esto es principalmente útil para el sondeo manual del estado de proceso.

refresh_state()

restart

Reinicie ComputeInstance.

restart(wait_for_completion=False, show_output=False)

Parámetros

Nombre Description
wait_for_completion

Boolean para esperar a la actualización de estado. El valor predeterminado es False.

Valor predeterminado: False
show_output

Boolean para proporcionar una salida más detallada. El valor predeterminado es False.

Valor predeterminado: False

Devoluciones

Tipo Description

Ninguno

Excepciones

Tipo Description
azureml.exceptions.ComputeTargetException:

serialize

Convierta este objeto ComputeInstance en un diccionario serializado JSON.

serialize()

Devoluciones

Tipo Description

Representación JSON de este objeto ComputeInstance.

start

Inicie ComputeInstance.

start(wait_for_completion=False, show_output=False)

Parámetros

Nombre Description
wait_for_completion

Si se debe esperar a la actualización de estado. El valor predeterminado es False.

Valor predeterminado: False
show_output

Indica si se debe proporcionar una salida más detallada. El valor predeterminado es False.

Valor predeterminado: False

Devoluciones

Tipo Description

Ninguno

Excepciones

Tipo Description

stop

Detenga ComputeInstance.

stop(wait_for_completion=False, show_output=False)

Parámetros

Nombre Description
wait_for_completion

Si se debe esperar a la actualización de estado. El valor predeterminado es False.

Valor predeterminado: False
show_output

Indica si se debe proporcionar una salida más detallada. El valor predeterminado es False.

Valor predeterminado: False

Devoluciones

Tipo Description

Ninguno

Excepciones

Tipo Description

supported_vmsizes

Enumere los tamaños de máquina virtual admitidos en una región.

static supported_vmsizes(workspace, location=None)

Parámetros

Nombre Description
workspace
Requerido

Área de trabajo.

location
str

Ubicación de la instancia. Si no se especifica, el valor predeterminado es la ubicación del área de trabajo.

Valor predeterminado: None

Devoluciones

Tipo Description

Lista de tamaños de máquina virtual admitidos en una región con el nombre de la máquina virtual, las VCPU y la RAM.

update_sso_settings

Actualice la configuración de inicio de sesión único de la instancia de proceso.

update_sso_settings(value)

Parámetros

Nombre Description
value
Requerido

Valor de la configuración de sso

Devoluciones

Tipo Description

Si la actualización se realizó correctamente o no

wait_for_completion

Espere a que ComputeInstance finalice el aprovisionamiento.

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. El valor predeterminado es False.

Valor predeterminado: False
is_delete_operation

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

Valor predeterminado: False

Excepciones

Tipo Description