AciWebservice Clase

Representa un modelo de aprendizaje automático implementado como punto de conexión de servicio web en Azure Container Instances.

Se crea un servicio implementado a partir de un modelo, un script y archivos asociados. El servicio web resultante es un punto de conexión HTTP con equilibrio de carga con una API REST. Puede enviar datos a esta API y recibir la predicción devuelta por el modelo.

Para más información, consulte Implementación de un modelo en Azure Container Instances.

Inicialice la instancia del servicio web.

El constructor de servicios web recupera una representación en la nube de un objeto de servicio web asociado al área de trabajo proporcionada. Devolverá una instancia de una clase secundaria correspondiente al tipo específico del objeto Webservice recuperado.

Constructor

AciWebservice(workspace, name)

Parámetros

Nombre	Description
workspace Requerido	Workspace Objeto de área de trabajo que contiene el objeto Webservice que se va a recuperar.
name Requerido	str Nombre del objeto web que se va a recuperar.

Comentarios

El patrón de implementación recomendado es crear un objeto de configuración de implementación con el deploy_configuration método y, a continuación, usarlo con el deploy método de la Model clase como se muestra a continuación.


   from azureml.core.model import InferenceConfig
   from azureml.core.webservice import AciWebservice


   service_name = 'my-custom-env-service'

   inference_config = InferenceConfig(entry_script='score.py', environment=environment)
   aci_config = AciWebservice.deploy_configuration(cpu_cores=1, memory_gb=1)

   service = Model.deploy(workspace=ws,
                          name=service_name,
                          models=[model],
                          inference_config=inference_config,
                          deployment_config=aci_config,
                          overwrite=True)
   service.wait_for_deployment(show_output=True)

Hay varias maneras de implementar un modelo como un servicio web, incluido con:

deploy método de Model para los modelos que ya están registrados en el área de trabajo.
deploy_from_image método de Webservice.
deploy_from_model método de para los modelos ya registrados en el área de Webservice trabajo. Este método creará una imagen.
deploy método de Webservice, que registrará un modelo y creará una imagen.

Para obtener información sobre cómo trabajar con servicios web, consulte

En la sección Variables se enumeran los atributos de una representación local del objeto AciWebservice en la nube. Estas variables deben considerarse de solo lectura. El cambio de sus valores no se reflejará en el objeto de nube correspondiente.

Variables

Nombre	Description
enable_app_insights	bool Indica si el registro de AppInsights está habilitado para el servicio web.
cname	str Cname para el servicio web.
container_resource_requirements	ContainerResourceRequirements Requisitos de recursos de contenedor para el servicio web.
encryption_properties	EncryptionProperties Propiedades de cifrado para el servicio web.
vnet_configuration	VnetConfiguration Las propiedades de red virtual para el servicio web, la configuración debe crearse y proporcionarse por el usuario.
azureml.core.webservice.AciWebservice.___location	str Ubicación en la que se implementa el servicio web.
public_ip	str Dirección IP pública del servicio web.
azureml.core.webservice.AciWebservice.scoring_uri	str Punto de conexión de puntuación para el servicio web
ssl_enabled	bool Si SSL está habilitado o no para el servicio web
public_fqdn	str FQDN público para el servicio web
environment	Environment Objeto Environment que se usó para crear el servicio web
azureml.core.webservice.AciWebservice.models	list[Model] Lista de modelos implementados en el servicio web
azureml.core.webservice.AciWebservice.swagger_uri	str Punto de conexión de swagger para el servicio web

Métodos

add_properties	Agregue pares clave-valor al diccionario de propiedades de este servicio web.
add_tags	Agregue pares clave-valor al diccionario de etiquetas de este servicio web.
deploy_configuration	Cree un objeto de configuración para implementar un servicio AciWeb.
get_token	Recupere el token de autenticación de este servicio web, con ámbito para el usuario actual. Nota: No implementado.
remove_tags	Quite las claves especificadas del diccionario de etiquetas de este servicio web.
run	Llame a este servicio web con la entrada proporcionada.
serialize	Convierta este servicio web en un diccionario serializado JSON.
update	Actualice el servicio web con las propiedades proporcionadas. Los valores que quedan como Ninguno permanecerán sin cambios en este servicio web.

add_properties

Agregue pares clave-valor al diccionario de propiedades de este servicio web.

add_properties(properties)

Parámetros

Nombre	Description
properties Requerido	dict[str, str] Diccionario de propiedades que se van a agregar.

add_tags

Agregue pares clave-valor al diccionario de etiquetas de este servicio web.

add_tags(tags)

Parámetros

Nombre	Description
tags Requerido	dict[str, str] Diccionario de etiquetas que se van a agregar.

Excepciones

Tipo	Description
WebserviceException

deploy_configuration

Cree un objeto de configuración para implementar un servicio AciWeb.

static deploy_configuration(cpu_cores=None, memory_gb=None, tags=None, properties=None, description=None, ___location=None, auth_enabled=None, ssl_enabled=None, enable_app_insights=None, ssl_cert_pem_file=None, ssl_key_pem_file=None, ssl_cname=None, dns_name_label=None, primary_key=None, secondary_key=None, collect_model_data=None, cmk_vault_base_url=None, cmk_key_name=None, cmk_key_version=None, vnet_name=None, subnet_name=None)

Parámetros

Nombre	Description
cpu_cores	float Número de núcleos de CPU que se van a asignar para este servicio web. Puede ser un decimal. El valor predeterminado es 0.1 Valor predeterminado: None
memory_gb	float Cantidad de memoria (en GB) que se va a asignar para este servicio web. Puede ser un decimal. El valor predeterminado es 0,5 Valor predeterminado: None
tags	dict[str, str] Diccionario de etiquetas de valor de clave que se van a proporcionar a este servicio web. Valor predeterminado: None
properties	dict[str, str] Diccionario de propiedades de valor de clave que se van a proporcionar a este servicio web. Estas propiedades no se pueden cambiar después de la implementación, pero se pueden agregar nuevos pares de valor de clave. Valor predeterminado: None
description	str Descripción para proporcionar este servicio web. Valor predeterminado: None
___location	str Región de Azure en la que se implementará este servicio web. Si no se especifica, se usará la ubicación del área de trabajo. Para obtener más información sobre las regiones disponibles, consulte Productos por región. Valor predeterminado: None
auth_enabled	bool Si se va a habilitar o no la autenticación para este servicio web. El valor predeterminado es False. Valor predeterminado: None
ssl_enabled	bool Indica si se va a habilitar SSL para este servicio web. El valor predeterminado es False. Valor predeterminado: None
enable_app_insights	bool Indica si se va a habilitar AppInsights para este servicio web. El valor predeterminado es False. Valor predeterminado: None
ssl_cert_pem_file	str El archivo de certificado necesario si SSL está habilitado. Valor predeterminado: None
ssl_key_pem_file	str El archivo de clave necesario si SSL está habilitado. Valor predeterminado: None
ssl_cname	str Cname para si SSL está habilitado. Valor predeterminado: None
dns_name_label	str Etiqueta de nombre DNS para el punto de conexión de puntuación. Si no se especifica una etiqueta de nombre DNS única, se generará para el punto de conexión de puntuación. Valor predeterminado: None
primary_key	str Clave de autenticación principal que se va a usar para este servicio web. Valor predeterminado: None
secondary_key	str Clave de autenticación secundaria que se va a usar para este servicio web. Valor predeterminado: None
collect_model_data	bool Indica si se va a habilitar la recopilación de datos del modelo para el servicio web. Valor predeterminado: None
cmk_vault_base_url	str dirección URL base del almacén de claves administrado por el cliente Valor predeterminado: None
cmk_key_name	str nombre de clave administrada por el cliente. Valor predeterminado: None
cmk_key_version	str versión de clave administrada por el cliente. Valor predeterminado: None
vnet_name	str nombre de red virtual. Valor predeterminado: None
subnet_name	str nombre de subred dentro de la red virtual. Valor predeterminado: None

Devoluciones

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

Excepciones

Tipo	Description
WebserviceException

get_token

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

Nota:

No implementado.

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

remove_tags

Quite las claves especificadas del diccionario de etiquetas de este servicio web.

remove_tags(tags)

Parámetros

Nombre	Description
tags Requerido	list[str] Lista de claves que se van a quitar.

run

Llame a este servicio web con la entrada proporcionada.

run(input_data)

Parámetros

Nombre	Description
input_data Requerido	<xref:varies> Entrada con la que llamar al servicio web.

Devoluciones

Tipo	Description
dict	Resultado de llamar al servicio web.

Excepciones

Tipo	Description
WebserviceException

serialize

Convierta este servicio web en un diccionario serializado JSON.

serialize()

Devoluciones

Tipo	Description
dict	Representación JSON de este objeto Webservice.

update

Actualice el servicio web con las propiedades proporcionadas.

Los valores que quedan como Ninguno permanecerán sin cambios en este servicio web.

update(image=None, tags=None, properties=None, description=None, auth_enabled=None, ssl_enabled=None, ssl_cert_pem_file=None, ssl_key_pem_file=None, ssl_cname=None, enable_app_insights=None, models=None, inference_config=None)

Parámetros

Nombre	Description
image	Image Nueva imagen que se va a implementar en el servicio web. Valor predeterminado: None
tags	dict[str, str] Diccionario de etiquetas de valor de clave que se van a proporcionar a este servicio web. Reemplazará las etiquetas existentes. Valor predeterminado: None
properties	dict[str, str] Diccionario de propiedades de valor clave que se van a agregar al diccionario de propiedades existentes. Valor predeterminado: None
description	str Descripción para proporcionar este servicio web. Valor predeterminado: None
auth_enabled	bool Habilite o deshabilite la autenticación para este servicio web. Valor predeterminado: None
ssl_enabled	bool Indica si se va a habilitar SSL para este servicio web. Valor predeterminado: None
ssl_cert_pem_file	str El archivo de certificado necesario si SSL está habilitado. Valor predeterminado: None
ssl_key_pem_file	str El archivo de clave necesario si SSL está habilitado. Valor predeterminado: None
ssl_cname	str Cname para si SSL está habilitado. Valor predeterminado: None
enable_app_insights	bool Indica si se va a habilitar AppInsights para este servicio web. Valor predeterminado: None
models	list[Model] Lista de objetos Model que se van a empaquetar en el servicio actualizado. Valor predeterminado: None
inference_config	InferenceConfig Objeto InferenceConfig usado para proporcionar las propiedades de implementación del modelo necesarias. Valor predeterminado: None

Devoluciones

Tipo	Description
None

Compartir a través de

AciWebservice Clase

Constructor

Parámetros

Comentarios

Variables

Métodos

add_properties

Parámetros

add_tags

Parámetros

Excepciones

deploy_configuration

Parámetros

Devoluciones

Excepciones

get_token

Devoluciones

Excepciones

remove_tags

Parámetros

run

Parámetros

Devoluciones

Excepciones

serialize

Devoluciones

update

Parámetros

Devoluciones

Comentarios