AciWebservice Clase
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
-
AciWebservice
Constructor
AciWebservice(workspace, name)
Parámetros
- workspace
- Workspace
Objeto Workspace que contiene el 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
Consumir un modelo de Azure Machine Learning que está implementado como un servicio web
Supervisión y recopilación de datos de los puntos de conexión del servicio web ML
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.
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
add_tags
Agrega pares valor-clave al diccionario de etiquetas de este Webservice.
add_tags(tags)
Parámetros
Excepciones
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
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
Cantidad de memoria (en GB) que se va a asignar a este Webservice. Puede ser un decimal. El valor predeterminado es 0,5.
Diccionario de etiquetas valor-clave para proporcionar a este Webservice.
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.
- 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.
- auth_enabled
- bool
Indica si se debe habilitar o no la autenticación para este servicio web. El valor predeterminado es False.
- ssl_enabled
- bool
Indica si se debe habilitar o no SSL para este servicio web. El valor predeterminado es False.
- enable_app_insights
- bool
Indica si se debe habilitar o no AppInsights para este servicio web. El valor predeterminado es False.
- ssl_cert_pem_file
- str
Archivo de certificado necesario si SSL está habilitado.
- 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.
- primary_key
- str
Clave de autenticación principal que se usará para este Webservice.
- secondary_key
- str
Clave de autenticación secundaria que se usará para este Webservice.
- collect_model_data
- bool
Indica si se debe habilitar o no la recopilación de datos del modelo para Webservice.
- cmk_vault_base_url
- str
Dirección URL base del almacén de claves administradas por el cliente.
Devoluciones
Objeto de configuración que se usará al implementar un objeto Webservice.
Tipo de valor devuelto
Excepciones
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
Excepciones
remove_tags
Quita las claves especificadas del diccionario de etiquetas de este Webservice.
remove_tags(tags)
Parámetros
run
Llama a este Webservice con la entrada proporcionada.
run(input_data)
Parámetros
- input_data
- <xref:varies>
Entrada con la que se llamará a Webservice.
Devoluciones
Resultado de llamar a Webservice.
Tipo de valor devuelto
Excepciones
serialize
Convierte este Webservice en un diccionario JSON serializado.
serialize()
Devoluciones
Representación JSON de este objeto Webservice.
Tipo de valor devuelto
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
Diccionario de etiquetas valor-clave para proporcionar a este Webservice. Reemplazará las etiquetas existentes.
Diccionario de propiedades valor-clave que se agregarán al diccionario de propiedades existente.
- auth_enabled
- bool
Habilita o deshabilita la autenticación para este Webservice.
- ssl_enabled
- bool
Indica si se debe habilitar o no SSL para este servicio web.
- ssl_cert_pem_file
- str
Archivo de certificado necesario si SSL está habilitado.
- enable_app_insights
- bool
Indica si se debe habilitar o no AppInsights para este servicio web.
Lista de objetos Model que se van a empaquetar en el servicio actualizado.
- inference_config
- InferenceConfig
Objeto InferenceConfig que se usa para proporcionar las propiedades de implementación del modelo necesarias.
Tipo de valor devuelto
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de