LocalWebservice Clase

Representa un modelo de Machine Learning implementado como un punto de conexión de servicio web local.

La implementación de servicios web localmente es útil para los escenarios de depuración y pruebas.

Constructor de servicios web locales.

El constructor LocalWebservice se usa para recuperar una representación local de un objeto LocalWebservice asociado al área de trabajo proporcionada.

Constructor

LocalWebservice(*args, **kwargs)

Parámetros

Nombre	Description
workspace Requerido	Workspace Objeto de área de trabajo que contiene los objetos Model que se recuperarán.
name Requerido	str Nombre del objeto Webservice que se va a recuperar.
must_exist Requerido	bool Si el servicio web ya debe existir al crear el objeto en memoria.
workspace Requerido	Workspace Objeto de área de trabajo que contiene los objetos Model que se recuperarán.
name Requerido	str Nombre del objeto LocalWebservice que se va a recuperar.
must_exist Requerido	bool Si el servicio web ya debe existir al crear el objeto en memoria.

Comentarios

En los ejemplos de código siguientes se muestra cómo crear un servicio web local de Docker. Consulte el vínculo del cuaderno para obtener más detalles.


   from azureml.core.webservice import LocalWebservice

   # This is optional, if not provided Docker will choose a random unused port.
   deployment_config = LocalWebservice.deploy_configuration(port=6789)

   local_service = Model.deploy(ws, "test", [model], inference_config, deployment_config)

   local_service.wait_for_deployment()

Métodos

delete	Elimine este servicio LocalWeb de la máquina local. Esta llamada de función no es asincrónica; se ejecuta hasta que se elimina el servicio.
deploy_configuration	Cree un objeto de configuración para implementar un servicio web local.
deploy_to_cloud	Implemente un servicio web basado en la configuración de LocalWebservice.
deserialize	Convierta un objeto JSON de respuesta del Servicio de administración de modelos en un objeto Webservice. Nota: No se admite para LocalWebservice.
get_keys	Recupere las claves de autenticación de este servicio web. Nota: No se admite para LocalWebservice.
get_logs	Recupere los registros de este localWebservice.
get_token	Recupere el token de autenticación de este servicio web, con ámbito para el usuario actual. Nota: No se admite para LocalWebservice.
list	Enumere los servicios LocalWeb asociados al área de trabajo correspondiente. Los resultados devueltos se pueden filtrar mediante parámetros.
regen_key	Vuelva a generar una de las claves del servicio web. Nota: No se admite para LocalWebservice.
reload	Vuelva a cargar el script de ejecución y las dependencias de LocalWebservice. Esto reinicia el contenedor del servicio con copias de los recursos actualizados, incluido el script de ejecución y las dependencias locales, pero no vuelve a generar la imagen subyacente. En consecuencia, los cambios en las dependencias de Conda/pip o los pasos personalizados de Docker no se reflejarán en el servicio LocalWeb reloaded. Para controlar esos cambios, llame al update método en su lugar.
run	Llame a este servicio LocalWeb con la entrada proporcionada.
serialize	Convierta este objeto Webservice en un diccionario serializado por JSON.
update	Actualice localWebservice con las propiedades proporcionadas. Los valores que quedan como None permanecerán sin cambios en este localWebservice.
update_deployment_state	Actualice el estado actual del objeto en memoria. Realice una actualización local de las propiedades del objeto en función del estado actual del contenedor local de Docker correspondiente.
wait_for_deployment	Sondee la implementación localWebservice en ejecución.

delete

Elimine este servicio LocalWeb de la máquina local.

Esta llamada de función no es asincrónica; se ejecuta hasta que se elimina el servicio.

delete(delete_cache=True, delete_image=False, delete_volume=True)

Parámetros

Nombre	Description
delete_cache Requerido	bool Si se van a eliminar archivos temporales almacenados en caché para el servicio. (Valor predeterminado: True)
delete_image Requerido	bool Si se va a eliminar la imagen de Docker del servicio. (Valor predeterminado: False)
delete_volume Requerido	bool Si se va a eliminar el volumen de Docker del servicio. (Valor predeterminado: True)

Excepciones

Tipo	Description
WebserviceException

deploy_configuration

Cree un objeto de configuración para implementar un servicio web local.

static deploy_configuration(port=None)

Parámetros

Nombre	Description
port	int Puerto local en el que se va a exponer el punto de conexión HTTP del servicio. Valor predeterminado: None

Devoluciones

Tipo	Description
LocalWebserviceDeploymentConfiguration	Objeto de configuración que se va a usar al implementar un objeto Webservice.

Excepciones

Tipo	Description
WebserviceException

deploy_to_cloud

Implemente un servicio web basado en la configuración de LocalWebservice.

deploy_to_cloud(name=None, deployment_config=None, deployment_target=None)

Parámetros

Nombre	Description
name	str Nombre que se va a asignar al servicio implementado. Debe ser único para el área de trabajo. Valor predeterminado: None
deployment_config	WebserviceDeploymentConfiguration WebserviceDeploymentConfiguration usado para configurar el servicio web. Si no se proporciona uno, se usará un objeto de configuración vacío en función del destino deseado. Valor predeterminado: None
deployment_target	ComputeTarget que ComputeTarget se va a implementar el servicio web. Como ACI no tiene asociado ComputeTarget, deje este parámetro como None para implementar en ACI. Valor predeterminado: None

Devoluciones

Tipo	Description
Webservice	Objeto webservice correspondiente al servicio web implementado.

Excepciones

Tipo	Description
WebserviceException

deserialize

Convierta un objeto JSON de respuesta del Servicio de administración de modelos en un objeto Webservice.

Nota:

No se admite para LocalWebservice.

deserialize(workspace, webservice_payload)

Parámetros

Nombre	Description
cls Requerido
workspace Requerido	Workspace Objeto de área de trabajo en el que está registrado el servicio web.
webservice_payload Requerido	dict Objeto JSON que se va a convertir en un objeto Webservice.

Excepciones

Tipo	Description
azureml.exceptions.NotImplementedError

get_keys

Recupere las claves de autenticación de este servicio web.

Nota:

No se admite para LocalWebservice.

get_keys()

Devoluciones

Tipo	Description
	Claves de autenticación para este servicio web.

Excepciones

Tipo	Description
azureml.exceptions.NotImplementedError

get_logs

Recupere los registros de este localWebservice.

get_logs(num_lines=5000, raw=False)

Parámetros

Nombre	Description
num_lines Requerido	int Número máximo de líneas de registro que se van a recuperar. (Valor predeterminado: 5000)
raw Requerido	bool Devuelve la salida del contenedor de Docker sin procesar sin intentar darle formato. (Valor predeterminado: False)

Devoluciones

Tipo	Description
str	Los registros de este localWebservice.

Excepciones

Tipo	Description
WebserviceException

get_token

Recupere el token de autenticación de este servicio web, con ámbito para el usuario actual.

Nota:

No se admite para LocalWebservice.

get_token()

Devoluciones

Tipo	Description
str, datetime	Token de autenticación para este servicio web y cuándo se debe actualizar después.

Excepciones

Tipo	Description
azureml.exceptions.NotImplementedError

list

Enumere los servicios LocalWeb asociados al área de trabajo correspondiente.

Los resultados devueltos se pueden filtrar mediante parámetros.

static list(workspace, model_name=None, model_id=None, all=None)

Parámetros

Nombre	Description
workspace Requerido	Workspace Objeto Workspace asociado a LocalWebservices.
model_name	str Lista de filtros para incluir solo LocalWebservices implementados con el nombre de modelo específico. Valor predeterminado: None
model_id	str Lista de filtros para incluir solo LocalWebservices implementados con el identificador de modelo específico. Valor predeterminado: None
all	bool Mostrar todos los servicios. De forma predeterminada, solo se muestran los servicios en ejecución. Valor predeterminado: None

Devoluciones

Tipo	Description
list[LocalWebservice]	Lista filtrada de LocalWebservices asociada al área de trabajo proporcionada.

Excepciones

Tipo	Description
WebserviceException

regen_key

Vuelva a generar una de las claves del servicio web.

Nota:

No se admite para LocalWebservice.

regen_key(key)

Parámetros

Nombre	Description
key Requerido	str Qué clave se va a regenerar. Las opciones son "Principal" o "Secundaria".

Excepciones

Tipo	Description
NotImplementedError

reload

Vuelva a cargar el script de ejecución y las dependencias de LocalWebservice.

Esto reinicia el contenedor del servicio con copias de los recursos actualizados, incluido el script de ejecución y las dependencias locales, pero no vuelve a generar la imagen subyacente. En consecuencia, los cambios en las dependencias de Conda/pip o los pasos personalizados de Docker no se reflejarán en el servicio LocalWeb reloaded. Para controlar esos cambios, llame al update método en su lugar.

reload(wait=False)

Parámetros

Nombre	Description
wait Requerido	bool Espere a que el contenedor del servicio alcance un estado correcto. (Valor predeterminado: False)

Excepciones

Tipo	Description
WebserviceException

run

Llame a este servicio LocalWeb con la entrada proporcionada.

run(input_data)

Parámetros

Nombre	Description
input_data Requerido	<xref:varies> Entrada con la que se va a llamar a LocalWebservice.

Devoluciones

Tipo	Description
<xref:varies>	Resultado de llamar a LocalWebservice.

Excepciones

Tipo	Description
WebserviceException

serialize

Convierta este objeto Webservice en un diccionario serializado por JSON.

serialize()

Devoluciones

Tipo	Description
dict	Representación serializada del objeto Webservice.

update

Actualice localWebservice con las propiedades proporcionadas.

Los valores que quedan como None permanecerán sin cambios en este localWebservice.

update(models=None, image_config=None, deployment_config=None, wait=False, inference_config=None)

Parámetros

Nombre	Description
models Requerido	list[Model] Nueva lista de modelos incluidos en localWebservice.
image_config Requerido	ContainerImageConfig Opciones de configuración de imágenes que se aplicarán al servicio LocalWeb.
deployment_config Requerido	LocalWebserviceDeploymentConfiguration Opciones de configuración de implementación que se aplicarán al servicio LocalWeb.
inference_config Requerido	InferenceConfig Objeto InferenceConfig usado para proporcionar las propiedades de implementación del modelo necesarias.
wait Requerido	bool Espere a que el contenedor del servicio alcance un estado correcto. (Valor predeterminado: False)

Devoluciones

Tipo	Description
None

Excepciones

Tipo	Description
WebserviceException

update_deployment_state

Actualice el estado actual del objeto en memoria.

Realice una actualización local de las propiedades del objeto en función del estado actual del contenedor local de Docker correspondiente.

update_deployment_state(must_exist=False)

Parámetros

Nombre	Description
must_exist	bool Si el servicio web ya debe existir al crear el objeto en memoria. Valor predeterminado: False

wait_for_deployment

Sondee la implementación localWebservice en ejecución.

wait_for_deployment(show_output=False)

Parámetros

Nombre	Description
show_output Requerido	bool Opción para imprimir una salida más detallada. (Valor predeterminado: False)

Excepciones

Tipo	Description
WebserviceException

Atributos

port

Obtenga el puerto del servicio web local.

Devoluciones

Tipo	Description
int	Número de puerto.

scoring_uri

Obtenga el URI de puntuación del servicio web local.

Devoluciones

Tipo	Description
str	URI de puntuación.

swagger_uri

Obtenga el URI de Swagger del servicio web local.

Devoluciones

Tipo	Description
str	URI de Swagger.

NETWORK_NAME

NETWORK_NAME = 'azureml-local'

STATE_DELETED

STATE_DELETED = 'deleted'

STATE_DEPLOYING

STATE_DEPLOYING = 'deploying'

STATE_FAILED

STATE_FAILED = 'failed'

STATE_RUNNING

STATE_RUNNING = 'running'

STATE_UNKNOWN

STATE_UNKNOWN = 'unknown'

Comentarios

¿Le ha resultado útil esta página?

Compartir a través de

LocalWebservice Clase

Constructor

Parámetros

Comentarios

Métodos

delete

Parámetros

Excepciones

deploy_configuration

Parámetros

Devoluciones

Excepciones

deploy_to_cloud

Parámetros

Devoluciones

Excepciones

deserialize

Parámetros

Excepciones

get_keys

Devoluciones

Excepciones

get_logs

Parámetros

Devoluciones

Excepciones

get_token

Devoluciones

Excepciones

list

Parámetros

Devoluciones

Excepciones

regen_key

Parámetros

Excepciones

reload

Parámetros

Excepciones

run

Parámetros

Devoluciones

Excepciones

serialize

Devoluciones

update

Parámetros

Devoluciones

Excepciones

update_deployment_state

Parámetros

wait_for_deployment

Parámetros

Excepciones

Atributos

port

Devoluciones

scoring_uri

Devoluciones

swagger_uri

Devoluciones

NETWORK_NAME

STATE_DELETED

STATE_DEPLOYING

STATE_FAILED

STATE_RUNNING

STATE_UNKNOWN

Comentarios