Compartir a través de

AciWebservice Clase

  • Referencia

Representa un modelo de Machine Learning implementado como punto de conexión de servicio web en Azure Container Instances.

Un servicio implementado se crea a partir de un modelo, un script y los 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 que devuelve el modelo.

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

Inicialice la instancia de servicio web.

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

Herencia
Webservice
AciWebservice

Constructor

AciWebservice(workspace, name)

Parámetros

Nombre Description
workspace
Requerido
Workspace

Objeto Workspace que contiene el objeto Webservice que se va a recuperar.
name
Requerido
str

Nombre del objeto Webservice 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 método deploy_configuration y luego usarlo con el método deploy de la clase Model 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, entre las cuales se incluyen las siguientes:

  • Método deploy de Model para los modelos ya registrados en el área de trabajo.

  • Método deploy_from_image de Webservice.

  • Método deploy_from_model de Webservice para los modelos ya registrados en el área de trabajo. Este método creará una imagen.

  • Método deploy 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

Si el registro de AppInsights está habilitado o no para Webservice.
cname
str

Cname para Webservice.
container_resource_requirements
ContainerResourceRequirements

Requisitos de recursos de contenedor para Webservice.
encryption_properties
EncryptionProperties

Propiedades de cifrado para Webservice.
vnet_configuration
VnetConfiguration

Propiedades de red virtual para Webservice, la configuración la debe crear y proporcionar el usuario.
azureml.core.webservice.AciWebservice.location
str

Ubicación en la que se implementa Webservice.
public_ip
str

Dirección IP pública de Webservice.
azureml.core.webservice.AciWebservice.scoring_uri
str

Punto de conexión de puntuación para Webservice.
ssl_enabled
bool

Si SSL está habilitada o no para Webservice.
public_fqdn
str

FQDN público para Webservice.
environment
Environment

Objeto Environment que se usó para crear el Webservice.
azureml.core.webservice.AciWebservice.models
list[Model]

Lista de modelos implementados en Webservice.
azureml.core.webservice.AciWebservice.swagger_uri
str

Punto de conexión de Swagger para Webservice.

Métodos

add_properties

Agrega pares clave-valor al diccionario de propiedades de este Webservice.
add_tags

Agrega pares valor-clave al diccionario de etiquetas de este Webservice.
deploy_configuration

Crea un objeto de configuración para implementar un objeto AciWebservice.
get_token

Se recupera el token de autenticación de este Webservice, limitado al usuario actual.

Nota

Sin implementar.
remove_tags

Quita las claves especificadas del diccionario de etiquetas de este Webservice.
run

Llama a este Webservice con la entrada proporcionada.
serialize

Convierte este Webservice en un diccionario JSON serializado.
update

Actualiza Webservice con las propiedades proporcionadas.

Los valores que se dejan como None permanecerán sin cambios en este Webservice.

add_properties

Agrega pares clave-valor al diccionario de propiedades de este Webservice.

add_properties(properties)

Parámetros

Nombre Description
properties
Requerido
dict[str, str]

Diccionario de las propiedades que se van a agregar.

add_tags

Agrega pares valor-clave al diccionario de etiquetas de este Webservice.

add_tags(tags)

Parámetros

Nombre Description
tags
Requerido
dict[str, str]

Diccionario de las etiquetas que se van a agregar.

Excepciones

Tipo Description
WebserviceException

deploy_configuration

Crea un objeto de configuración para implementar un objeto AciWebservice.

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 asignarán a este Webservice. 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 a este Webservice. Puede ser un decimal. El valor predeterminado es 0,5.

Valor predeterminado: None
tags
dict[str, str]

Diccionario de etiquetas valor-clave para proporcionar a este Webservice.

Valor predeterminado: None
properties
dict[str, str]

Diccionario de propiedades valor-clave para proporcionar este Webservice. Estas propiedades no se pueden cambiar después de la implementación, pero se pueden agregar nuevos pares clave-valor.

Valor predeterminado: None
description
str

Descripción para proporcionar a este Webservice.

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 más información sobre las regiones disponibles, consulte Productos por región.

Valor predeterminado: None
auth_enabled
bool

Indica si se debe habilitar o no la autenticación para este servicio web. El valor predeterminado es False.

Valor predeterminado: None
ssl_enabled
bool

Indica si se debe habilitar o no SSL para este servicio web. El valor predeterminado es False.

Valor predeterminado: None
enable_app_insights
bool

Indica si se debe habilitar o no AppInsights para este servicio web. El valor predeterminado es False.

Valor predeterminado: None
ssl_cert_pem_file
str

Archivo de certificado necesario si SSL está habilitado.

Valor predeterminado: None
ssl_key_pem_file
str

Archivo de clave necesario si SSL está habilitado.

Valor predeterminado: None
ssl_cname
str

CNAME si SSL está habilitado.

Valor predeterminado: None
dns_name_label
str

Etiqueta del nombre DNS para el punto de conexión de puntuación. Si no se especifica, se generará una etiqueta de nombre DNS única para el punto de conexión de puntuación.

Valor predeterminado: None
primary_key
str

Clave de autenticación principal que se usará para este Webservice.

Valor predeterminado: None
secondary_key
str

Clave de autenticación secundaria que se usará para este Webservice.

Valor predeterminado: None
collect_model_data
bool

Indica si se debe habilitar o no la recopilación de datos del modelo para Webservice.

Valor predeterminado: None
cmk_vault_base_url
str

Dirección URL base del almacén de claves administradas 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 usará al implementar un objeto Webservice.

Excepciones

Tipo Description
WebserviceException

get_token

Se recupera el token de autenticación de este Webservice, limitado al usuario actual.

Nota

Sin implementar.

get_token()

Devoluciones

Tipo Description
str, datetime

Token de autenticación para este Webservice y cuándo se debe actualizar después.

Excepciones

Tipo Description
azureml.exceptions.NotImplementedError

remove_tags

Quita las claves especificadas del diccionario de etiquetas de este Webservice.

remove_tags(tags)

Parámetros

Nombre Description
tags
Requerido
list[str]

Lista de claves que se eliminarán.

run

Llama a este Webservice con la entrada proporcionada.

run(input_data)

Parámetros

Nombre Description
input_data
Requerido
<xref:varies>

Entrada con la que se llamará a Webservice.

Devoluciones

Tipo Description
dict

Resultado de llamar a Webservice.

Excepciones

Tipo Description
WebserviceException

serialize

Convierte este Webservice en un diccionario JSON serializado.

serialize()

Devoluciones

Tipo Description
dict

Representación JSON de este objeto Webservice.

update

Actualiza Webservice con las propiedades proporcionadas.

Los valores que se dejan como None permanecerán sin cambios en este Webservice.

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 implementará en Webservice.

Valor predeterminado: None
tags
dict[str, str]

Diccionario de etiquetas valor-clave para proporcionar a este Webservice. Reemplazará las etiquetas existentes.

Valor predeterminado: None
properties
dict[str, str]

Diccionario de propiedades valor-clave que se agregarán al diccionario de propiedades existente.

Valor predeterminado: None
description
str

Descripción para proporcionar a este Webservice.

Valor predeterminado: None
auth_enabled
bool

Habilita o deshabilita la autenticación para este Webservice.

Valor predeterminado: None
ssl_enabled
bool

Indica si se debe habilitar o no SSL para este servicio web.

Valor predeterminado: None
ssl_cert_pem_file
str

Archivo de certificado necesario si SSL está habilitado.

Valor predeterminado: None
ssl_key_pem_file
str

Archivo de clave necesario si SSL está habilitado.

Valor predeterminado: None
ssl_cname
str

CNAME si SSL está habilitado.

Valor predeterminado: None
enable_app_insights
bool

Indica si se debe habilitar o no 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 que se usa para proporcionar las propiedades de implementación del modelo necesarias.

Valor predeterminado: None

Devoluciones

Tipo Description
None