Compartir a través de

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'