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

workspace
Workspace
Requerido

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

name
str
Requerido

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

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

properties
dict[str, str]
Requerido

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

tags
dict[str, str]
Requerido

Diccionario de las etiquetas que se van a agregar.

Excepciones

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

cpu_cores
float
valor predeterminado: None

Número de núcleos de CPU que se asignarán a este Webservice. Puede ser un decimal. El valor predeterminado es 0,1.

memory_gb
float
valor predeterminado: None

Cantidad de memoria (en GB) que se va a asignar a este Webservice. Puede ser un decimal. El valor predeterminado es 0,5.

tags
dict[str, str]
valor predeterminado: None

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

properties
dict[str, str]
valor predeterminado: None

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.

description
str
valor predeterminado: None

Descripción para proporcionar a este Webservice.

location
str
valor predeterminado: None

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.

auth_enabled
bool
valor predeterminado: None

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

ssl_enabled
bool
valor predeterminado: None

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

enable_app_insights
bool
valor predeterminado: None

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

ssl_cert_pem_file
str
valor predeterminado: None

Archivo de certificado necesario si SSL está habilitado.

ssl_key_pem_file
str
valor predeterminado: None

Archivo de clave necesario si SSL está habilitado.

ssl_cname
str
valor predeterminado: None

CNAME si SSL está habilitado.

dns_name_label
str
valor predeterminado: None

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.

primary_key
str
valor predeterminado: None

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

secondary_key
str
valor predeterminado: None

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

collect_model_data
bool
valor predeterminado: None

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

cmk_vault_base_url
str
valor predeterminado: None

Dirección URL base del almacén de claves administradas por el cliente.

cmk_key_name
str
valor predeterminado: None

nombre de clave administrada por el cliente.

cmk_key_version
str
valor predeterminado: None

versión de clave administrada por el cliente.

vnet_name
str
valor predeterminado: None

nombre de red virtual.

subnet_name
str
valor predeterminado: None

Nombre de subred dentro de la red virtual.

Devoluciones

Objeto de configuración que se usará al implementar un objeto Webservice.

Tipo de valor devuelto

AciServiceDeploymentConfiguration

Excepciones

WebserviceException

get_token

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

Nota

Sin implementar.

get_token()

Devoluciones

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

Tipo de valor devuelto

str, datetime

Excepciones

azureml.exceptions.NotImplementedError

remove_tags

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

remove_tags(tags)

Parámetros

tags
list[str]
Requerido

Lista de claves que se eliminarán.

run

Llama a este Webservice con la entrada proporcionada.

run(input_data)

Parámetros

input_data
<xref:varies>
Requerido

Entrada con la que se llamará a Webservice.

Devoluciones

Resultado de llamar a Webservice.

Tipo de valor devuelto

dict

Excepciones

WebserviceException

serialize

Convierte este Webservice en un diccionario JSON serializado.

serialize()

Devoluciones

Representación JSON de este objeto Webservice.

Tipo de valor devuelto

dict

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

image
Image
valor predeterminado: None

Nueva imagen que se implementará en Webservice.

tags
dict[str, str]
valor predeterminado: None

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

properties
dict[str, str]
valor predeterminado: None

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

description
str
valor predeterminado: None

Descripción para proporcionar a este Webservice.

auth_enabled
bool
valor predeterminado: None

Habilita o deshabilita la autenticación para este Webservice.

ssl_enabled
bool
valor predeterminado: None

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

ssl_cert_pem_file
str
valor predeterminado: None

Archivo de certificado necesario si SSL está habilitado.

ssl_key_pem_file
str
valor predeterminado: None

Archivo de clave necesario si SSL está habilitado.

ssl_cname
str
valor predeterminado: None

CNAME si SSL está habilitado.

enable_app_insights
bool
valor predeterminado: None

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

models
list[Model]
valor predeterminado: None

Lista de objetos Model que se van a empaquetar en el servicio actualizado.

inference_config
InferenceConfig
valor predeterminado: None

Objeto InferenceConfig que se usa para proporcionar las propiedades de implementación del modelo necesarias.

Tipo de valor devuelto

None