LocalWebservice Clase
Representa un modelo de Machine Learning implementado como un punto de conexión de servicio web local.
La implementación local de servicios web es útil para 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.
- Herencia
-
LocalWebservice
Constructor
LocalWebservice(*args, **kwargs)
Parámetros
Nombre | Description |
---|---|
workspace
Requerido
|
Objeto Workspace que contiene los objetos de modelo que se van a recuperar. |
name
Requerido
|
Nombre del objeto Webservice que se va a recuperar. |
must_exist
Requerido
|
Indica si el servicio web ya debe existir al crear el objeto en memoria. |
workspace
Requerido
|
Objeto Workspace que contiene los objetos de modelo que se van a recuperar. |
name
Requerido
|
Nombre del objeto LocalWebservice que se va a recuperar. |
must_exist
Requerido
|
Indica 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 de Docker local. 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()
El ejemplo completo está disponible en https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/deployment/deploy-to-local/register-model-deploy-local.ipynb.
Métodos
delete |
Elimina este servicio LocalWebservice del equipo local. Esta llamada de función no es asincrónica; se ejecuta hasta que se elimina el servicio. |
deploy_configuration |
Crea un objeto de configuración para implementar un objeto Webservice local. |
deploy_to_cloud |
Implementa un objeto Webservice basado en la configuración de LocalWebservice. |
deserialize |
Convierte un objeto JSON de respuesta del servicio de administración de modelos en un objeto Webservice. Nota No se admite para LocalWebservice. |
get_keys |
Recupera las claves de autenticación para este objeto Webservice. Nota No se admite para LocalWebservice. |
get_logs |
Recupera los registros de este servicio LocalWebservice. |
get_token |
Se recupera el token de autenticación de este Webservice, limitado al usuario actual. Nota No se admite para LocalWebservice. |
list |
Enumera los servicios LocalWebservices asociados al objeto Workspace correspondiente. Los resultados devueltos se pueden filtrar mediante parámetros. |
regen_key |
Vuelve a generar una de las claves del objeto Webservice. Nota No se admite para LocalWebservice. |
reload |
Vuelve a cargar el script de ejecución y las dependencias de LocalWebservice. Esto reinicia el contenedor del servicio con copias de los recursos actualizados, incluidos 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 y pip o en los pasos personalizados de Docker no se reflejarán en el servicio LocalWebservice recargado. Para controlar esos cambios, llame al método update en su lugar. |
run |
Llama a este servicio LocalWebservice con la entrada proporcionada. |
serialize |
Convierte este objeto Webservice en un diccionario serializado JSON. |
update |
Actualiza LocalWebservice con las propiedades proporcionadas. Los valores que se dejan como None permanecerán sin cambios en este servicio LocalWebservice. |
update_deployment_state |
Actualiza el estado actual del objeto en memoria. Realiza una actualización local de las propiedades del objeto en función del estado actual del contenedor Docker local correspondiente. |
wait_for_deployment |
Sondea la implementación de LocalWebservice en ejecución. |
delete
Elimina este servicio LocalWebservice del equipo 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
|
Indica si se van a eliminar los archivos temporales almacenados en caché para el servicio. (Valor predeterminado: Verdadero) |
delete_image
Requerido
|
Indica si se va a eliminar la imagen de Docker del servicio. (Valor predeterminado: False) |
delete_volume
Requerido
|
Indica si se va a eliminar el volumen de Docker del servicio. (Valor predeterminado: Verdadero) |
Excepciones
Tipo | Description |
---|---|
deploy_configuration
Crea un objeto de configuración para implementar un objeto Webservice local.
static deploy_configuration(port=None)
Parámetros
Nombre | Description |
---|---|
port
|
Puerto local en el que se va a exponer el punto de conexión HTTP del servicio. Valor predeterminado: None
|
Devoluciones
Tipo | Description |
---|---|
Objeto de configuración que se usará al implementar un objeto Webservice. |
Excepciones
Tipo | Description |
---|---|
deploy_to_cloud
Implementa un objeto Webservice basado en la configuración de LocalWebservice.
deploy_to_cloud(name=None, deployment_config=None, deployment_target=None)
Parámetros
Nombre | Description |
---|---|
name
|
Nombre que se va a dar al servicio implementado. Debe ser único para el área de trabajo. Valor predeterminado: None
|
deployment_config
|
Objeto WebserviceDeploymentConfiguration que se usa para configurar el servicio web. Si no se proporciona ninguno, se usará un objeto de configuración vacío en función del destino deseado. Valor predeterminado: None
|
deployment_target
|
Elemento ComputeTarget en el que se va a implementar el objeto Webservice. Dado que ACI no tiene un elemento ComputeTarget asociado, deje este parámetro como None para la implementación en ACI. Valor predeterminado: None
|
Devoluciones
Tipo | Description |
---|---|
Objeto Webservice correspondiente al servicio web implementado. |
Excepciones
Tipo | Description |
---|---|
deserialize
Convierte 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
|
Objeto Workspace en el que está registrado el objeto Webservice. |
webservice_payload
Requerido
|
Objeto JSON que se va a convertir en un objeto Webservice. |
Excepciones
Tipo | Description |
---|---|
azureml.exceptions.NotImplementedError
|
get_keys
Recupera las claves de autenticación para este objeto Webservice.
Nota
No se admite para LocalWebservice.
get_keys()
Devoluciones
Tipo | Description |
---|---|
Claves de autenticación para este objeto Webservice. |
Excepciones
Tipo | Description |
---|---|
azureml.exceptions.NotImplementedError
|
get_logs
Recupera los registros de este servicio LocalWebservice.
get_logs(num_lines=5000, raw=False)
Parámetros
Nombre | Description |
---|---|
num_lines
Requerido
|
Número máximo de líneas de registro que se van a recuperar. (Valor predeterminado: 5000) |
raw
Requerido
|
Devuelve la salida del contenedor Docker sin procesar sin intentar darle formato. (Valor predeterminado: False) |
Devoluciones
Tipo | Description |
---|---|
Registros de este servicio LocalWebservice. |
Excepciones
Tipo | Description |
---|---|
get_token
Se recupera el token de autenticación de este Webservice, limitado al usuario actual.
Nota
No se admite para LocalWebservice.
get_token()
Devoluciones
Tipo | Description |
---|---|
Token de autenticación para este Webservice y cuándo se debe actualizar después. |
Excepciones
Tipo | Description |
---|---|
azureml.exceptions.NotImplementedError
|
list
Enumera los servicios LocalWebservices asociados al objeto Workspace 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
|
Objeto Workspace asociado a LocalWebservices. |
model_name
|
Filtra la lista para que incluya solo los objetos LocalWebservices implementados con el nombre del modelo específico. Valor predeterminado: None
|
model_id
|
Filtra la lista para que incluya solo los objetos LocalWebservices implementados con el identificador del modelo específico. Valor predeterminado: None
|
all
|
Muestra todos los servicios. De forma predeterminada, solo se muestran los servicios en ejecución. Valor predeterminado: None
|
Devoluciones
Tipo | Description |
---|---|
Lista filtrada de objetos LocalWebservices asociada al objeto Workspace proporcionado. |
Excepciones
Tipo | Description |
---|---|
regen_key
Vuelve a generar una de las claves del objeto Webservice.
Nota
No se admite para LocalWebservice.
regen_key(key)
Parámetros
Nombre | Description |
---|---|
key
Requerido
|
Indica qué clave se va a regenerar. Las opciones son "Primary" (Principal) o "Secondary" (Secundaria). |
Excepciones
Tipo | Description |
---|---|
reload
Vuelve a cargar el script de ejecución y las dependencias de LocalWebservice.
Esto reinicia el contenedor del servicio con copias de los recursos actualizados, incluidos 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 y pip o en los pasos personalizados de Docker no se reflejarán en el servicio LocalWebservice recargado. Para controlar esos cambios, llame al método update en su lugar.
reload(wait=False)
Parámetros
Nombre | Description |
---|---|
wait
Requerido
|
Espera a que el contenedor del servicio alcance un estado correcto. (Valor predeterminado: False) |
Excepciones
Tipo | Description |
---|---|
run
Llama a este servicio LocalWebservice 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 |
---|---|
serialize
Convierte este objeto Webservice en un diccionario serializado JSON.
serialize()
Devoluciones
Tipo | Description |
---|---|
Representación serializada del objeto Webservice. |
Excepciones
Tipo | Description |
---|---|
update
Actualiza LocalWebservice con las propiedades proporcionadas.
Los valores que se dejan como None permanecerán sin cambios en este servicio LocalWebservice.
update(models=None, image_config=None, deployment_config=None, wait=False, inference_config=None)
Parámetros
Nombre | Description |
---|---|
models
Requerido
|
Nueva lista de modelos contenidos en LocalWebservice. |
image_config
Requerido
|
Opciones de configuración de imágenes que se aplicarán al servicio LocalWebservice. |
deployment_config
Requerido
|
Opciones de configuración de la implementación que se aplicarán al servicio LocalWebservice. |
inference_config
Requerido
|
Objeto InferenceConfig que se usa para proporcionar las propiedades de implementación del modelo necesarias. |
wait
Requerido
|
Espera a que el contenedor del servicio alcance un estado correcto. (Valor predeterminado: False) |
Devoluciones
Tipo | Description |
---|---|
Excepciones
Tipo | Description |
---|---|
update_deployment_state
Actualiza el estado actual del objeto en memoria.
Realiza una actualización local de las propiedades del objeto en función del estado actual del contenedor Docker local correspondiente.
update_deployment_state(must_exist=False)
Parámetros
Nombre | Description |
---|---|
must_exist
|
Indica si el servicio web ya debe existir al crear el objeto en memoria. Valor predeterminado: False
|
Excepciones
Tipo | Description |
---|---|
wait_for_deployment
Sondea la implementación de LocalWebservice en ejecución.
wait_for_deployment(show_output=False)
Parámetros
Nombre | Description |
---|---|
show_output
Requerido
|
Opción para imprimir una salida más detallada. (Valor predeterminado: False) |
Excepciones
Tipo | Description |
---|---|
Atributos
port
scoring_uri
Obtiene el identificador URI de puntuación del servicio web local.
Devoluciones
Tipo | Description |
---|---|
Identificador URI de puntuación. |
swagger_uri
Obtiene el identificador URI de Swagger del servicio web local.
Devoluciones
Tipo | Description |
---|---|
Identificador 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'