Compartir a través de

ComputeInstance Clase

  • Referencia

Administra un entorno de desarrollo 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 en 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.

Herencia
ComputeTarget
ComputeInstance

Constructor

ComputeInstance(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 va a recuperar.

Métodos

delete

Elimina el objeto ComputeInstance de su área de trabajo asociada.
deserialize

Convierte un objeto JSON en un objeto ComputeInstance.

Se producirá un error si el área de trabajo proporcionada no es el área de trabajo a la que está asociado el objeto ComputeInstance.
detach

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

Devuelve el objeto ComputeInstance.
get_active_runs

Devuelve un generador de las ejecuciones de este proceso.
get_docs_url

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

Recupera el estado detallado actual de ComputeInstance.
provisioning_configuration

Crea un objeto de configuración para aprovisionar un destino de ComputeInstance.
refresh_state

Realiza 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 principalmente es útil para el sondeo manual del estado de proceso.
restart

Reinicia ComputeInstance.
serialize

Convierte este objeto ComputeInstance en un diccionario serializado JSON.
start

Inicia ComputeInstance.
stop

Detiene ComputeInstance.
supported_vmsizes

Muestra los tamaños de máquina virtual admitidos de una región.
wait_for_completion

Espera a que ComputeInstance finalice el aprovisionamiento.

delete

Elimina 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
ComputeTargetException

Comentarios

Si este objeto se creó mediante Azure ML, también se eliminarán los objetos basados en la nube correspondientes. Si este objeto se creó externamente y solo se asocia al área de trabajo, se producirá una excepción y no cambiará nada.

deserialize

Convierte un objeto JSON en un objeto ComputeInstance.

Se producirá un error si el área de trabajo proporcionada no es el área de trabajo a la que está asociado el objeto ComputeInstance.

static deserialize(workspace, object_dict)

Parámetros

Nombre Description
workspace
Requerido
Workspace

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

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

Devoluciones

Tipo Description
ComputeInstance

Representación de ComputeInstance del objeto JSON proporcionado.

Excepciones

Tipo Description
ComputeTargetException

detach

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

detach()

Excepciones

Tipo Description
ComputeTargetException

La operación no es compatible.

get

Devuelve el objeto ComputeInstance.

get()

Devoluciones

Tipo Description
ComputeInstance

Representación de ComputeInstance del objeto JSON proporcionado.

Excepciones

Tipo Description
ComputeTargetException

get_active_runs

Devuelve un generador de las ejecuciones de este proceso.

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

Parámetros

Nombre Description
type
str

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

Valor predeterminado: None
tags
str o dict

Filtra las ejecuciones por "etiqueta" o {"etiqueta": "valor"}

Valor predeterminado: None
properties
str o dict

Filtra las ejecuciones por "propiedad" o {"propiedad": "valor"}

Valor predeterminado: None
status
str

El estado de ejecución puede ser "En ejecución" o "En cola".

Valor predeterminado: None

Devoluciones

Tipo Description
<xref:builtin.generator>

Un generador de azureml._restclient.models.RunDto

Excepciones

Tipo Description
ComputeTargetException

get_docs_url

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

get_docs_url()

Devoluciones

Tipo Description
str

url

Excepciones

Tipo Description
ComputeTargetException

get_status

Recupera el estado detallado actual de ComputeInstance.

get_status()

Devoluciones

Tipo Description
ComputeInstanceStatus

Objeto de estado detallado del proceso

Excepciones

Tipo Description
ComputeTargetException

provisioning_configuration

Crea un objeto de configuración para aprovisionar un destino de 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 de agente. Se pueden 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
bool

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
dict[str, str]

Diccionario opcional de etiquetas de clave-valor que se asocian 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 del objeto de AAD del usuario asignado (versión preliminar).

Valor predeterminado: None
assigned_user_tenant_id
str

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

Valor predeterminado: None

Devoluciones

Tipo Description
ComputeInstanceProvisioningConfiguration

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

Excepciones

Tipo Description
ComputeTargetException

refresh_state

Realiza 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 principalmente es útil para el sondeo manual del estado de proceso.

refresh_state()

Excepciones

Tipo Description
ComputeTargetException

restart

Reinicia ComputeInstance.

restart(wait_for_completion=False, show_output=False)

Parámetros

Nombre Description
wait_for_completion
bool

Valor booleano para esperar a la actualización del estado. El valor predeterminado es False.

Valor predeterminado: False
show_output
bool

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

Valor predeterminado: False

Devoluciones

Tipo Description
None

None

Excepciones

Tipo Description
azureml.exceptions.ComputeTargetException:

serialize

Convierte este objeto ComputeInstance en un diccionario serializado JSON.

serialize()

Devoluciones

Tipo Description
dict

Representación JSON de este objeto ComputeInstance.

Excepciones

Tipo Description
ComputeTargetException

start

Inicia ComputeInstance.

start(wait_for_completion=False, show_output=False)

Parámetros

Nombre Description
wait_for_completion
bool

Determina si se debe esperar a la actualización del estado. El valor predeterminado es False.

Valor predeterminado: False
show_output
bool

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

Valor predeterminado: False

Devoluciones

Tipo Description
None

None

Excepciones

Tipo Description
ComputeTargetException

stop

Detiene ComputeInstance.

stop(wait_for_completion=False, show_output=False)

Parámetros

Nombre Description
wait_for_completion
bool

Determina si se debe esperar a la actualización del estado. El valor predeterminado es False.

Valor predeterminado: False
show_output
bool

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

Valor predeterminado: False

Devoluciones

Tipo Description
None

None

Excepciones

Tipo Description
ComputeTargetException

supported_vmsizes

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

static supported_vmsizes(workspace, location=None)

Parámetros

Nombre Description
workspace
Requerido
Workspace

Área de trabajo.
location
str

Ubicación de la instancia. Si no se especifica, la opción predeterminada es la ubicación del área de trabajo.

Valor predeterminado: None

Devoluciones

Tipo Description
list

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

Excepciones

Tipo Description
ComputeTargetException

wait_for_completion

Espera a que ComputeInstance finalice el aprovisionamiento.

wait_for_completion(show_output=False, is_delete_operation=False)

Parámetros

Nombre Description
show_output
bool

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

Valor predeterminado: False
is_delete_operation
bool

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

Valor predeterminado: False

Excepciones

Tipo Description
ComputeTargetException