AciWebservice Classe

Représente un modèle de Machine Learning déployé en tant que point de terminaison de service Web sur Azure Container Instances.

Un service déployé est créé à partir d’un modèle, d’un script et de fichiers associés. Le service Web résultant est un point de terminaison HTTP à charge équilibrée avec une API REST. Vous pouvez envoyer des données à cette API et recevoir la prédiction retournée par le modèle.

Pour plus d’informations, consultez Déployer un modèle dans Azure Container Instances.

Héritage
AciWebservice

Constructeur

AciWebservice(workspace, name)

Remarques

Le modèle de déploiement recommandé consiste à créer un objet de configuration de déploiement avec la deploy_configuration méthode, puis à l’utiliser avec la deploy méthode de la Model classe, comme indiqué ci-dessous.


   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)

L’exemple complet est disponible dans https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/deployment/deploy-to-cloud/model-register-and-deploy.ipynb

Il existe plusieurs façons de déployer un modèle en tant que service Web, notamment avec :

  • deploy méthode de Model pour les modèles déjà inscrits dans l’espace de travail.

  • deploy_from_image méthode de Webservice .

  • deploy_from_model méthode de Webservice pour les modèles déjà inscrits dans l’espace de travail. Cette méthode crée une image.

  • deploy méthode du Webservice , qui inscrit un modèle et crée une image.

Pour plus d’informations sur l’utilisation des WebServices, consultez.

La section variables répertorie les attributs d’une représentation locale de l’objet Cloud AciWebservice. Ces variables doivent être considérées comme étant en lecture seule. La modification de leurs valeurs ne sera pas reflétée dans l’objet Cloud correspondant.

Variables

enable_app_insights
<xref:bool>

Indique si la journalisation AppInsights est activée ou non pour le service Web.

cname
<xref:str>

Enregistrement CNAME pour le service Web.

container_resource_requirements
ContainerResourceRequirements

Exigences en matière de ressources de conteneur pour le service Web.

encryption_properties
EncryptionProperties

Propriétés de chiffrement pour le service Web.

vnet_configuration
VnetConfiguration

Les propriétés du réseau virtuel pour le service Web, configuration doivent être créées et fournies par l’utilisateur.

azureml.core.webservice.AciWebservice.location
<xref:str>

Emplacement vers lequel le service Web est déployé.

public_ip
<xref:str>

Adresse IP publique du service Web.

azureml.core.webservice.AciWebservice.scoring_uri
<xref:str>

Point de terminaison de notation pour le service Web

ssl_enabled
<xref:bool>

Indique si SSL est activé ou non pour le service Web

public_fqdn
<xref:str>

Nom de domaine complet public pour le service Web

environment
Environnement

Objet d’environnement utilisé pour créer le service Web

azureml.core.webservice.AciWebservice.models
list[Model]

Liste des modèles déployés sur le service Web

azureml.core.webservice.AciWebservice.swagger_uri
<xref:str>

Point de terminaison Swagger pour le service Web

Méthodes

add_properties

Ajoutez des paires clé-valeur au dictionnaire de propriétés de ce service Web.

add_tags

Ajoutez des paires clé-valeur au dictionnaire de balises de ce service Web.

deploy_configuration

Créez un objet de configuration pour le déploiement d’un AciWebservice.

get_token

Récupère le jeton d’authentification pour ce service Web, limité à l’utilisateur actuel.

Notes

Non implémenté.

remove_tags

Supprimez les clés spécifiées du dictionnaire de balises WebService.

run

Appelez ce service Web avec l’entrée fournie.

serialize

Convertissez ce service Web en dictionnaire JSON sérialisé.

update

Mettez à jour le service Web avec les propriétés fournies.

Les valeurs laissées en aucune demeureront inchangées dans ce service Web.

add_properties

Ajoutez des paires clé-valeur au dictionnaire de propriétés de ce service Web.

add_properties(properties)

Paramètres

properties
<xref:dict>[<xref:str>, <xref:str>]

Dictionnaire de propriétés à ajouter.

add_tags

Ajoutez des paires clé-valeur au dictionnaire de balises de ce service Web.

add_tags(tags)

Paramètres

tags
<xref:dict>[<xref:str>, <xref:str>]

Dictionnaire de balises à ajouter.

Exceptions

deploy_configuration

Créez un objet de configuration pour le déploiement d’un AciWebservice.

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)

Paramètres

cpu_cores
<xref:float>
valeur par défaut: None

Nombre de cœurs de processeur à allouer pour ce service Web. Peut être un nombre décimal. La valeur par défaut est 0,1

memory_gb
<xref:float>
valeur par défaut: None

Quantité de mémoire (en Go) à allouer à ce service Web. Peut être un nombre décimal. La valeur par défaut est 0,5

tags
<xref:dict>[<xref:str>, <xref:str>]
valeur par défaut: None

Dictionnaire de balises de valeur de clé à attribuer à ce service Web.

properties
<xref:dict>[<xref:str>, <xref:str>]
valeur par défaut: None

Dictionnaire de propriétés de valeur de clé à attribuer à ce service Web. Ces propriétés ne peuvent pas être modifiées après le déploiement, toutefois, de nouvelles paires clé/valeur peuvent être ajoutées.

description
<xref:str>
valeur par défaut: None

Description pour fournir ce service Web.

location
<xref:str>
valeur par défaut: None

Région Azure dans laquelle déployer ce service web. Si elle n’est pas spécifiée, l’emplacement de l’espace de travail sera utilisé. Pour plus d’informations sur les régions disponibles, consultez produits par région.

auth_enabled
<xref:bool>
valeur par défaut: None

Indique s’il faut activer ou pas l’authentification pour ce service web. Valeur par défaut False.

ssl_enabled
<xref:bool>
valeur par défaut: None

Indique s’il faut activer ou pas SSL pour ce service web. Valeur par défaut False.

enable_app_insights
<xref:bool>
valeur par défaut: None

Indique s’il faut activer ou pas AppInsights pour ce service web. Valeur par défaut False.

ssl_cert_pem_file
<xref:str>
valeur par défaut: None

Le fichier de certificat est nécessaire si le protocole SSL est activé.

ssl_key_pem_file
<xref:str>
valeur par défaut: None

Fichier de clé nécessaire si le protocole SSL est activé.

ssl_cname
<xref:str>
valeur par défaut: None

CNAME pour si SSL est activé.

dns_name_label
<xref:str>
valeur par défaut: None

Étiquette du nom DNS pour le point de terminaison de notation. S’il n’est pas spécifié, une étiquette de nom DNS unique sera générée pour le point de terminaison de notation.

primary_key
<xref:str>
valeur par défaut: None

Clé d’authentification principale à utiliser pour ce service Web.

secondary_key
<xref:str>
valeur par défaut: None

Clé d’authentification secondaire à utiliser pour ce service Web.

collect_model_data
<xref:bool>
valeur par défaut: None

Indique si la collecte de données de modèle doit être activée pour le service Web.

cmk_vault_base_url
<xref:str>
valeur par défaut: None

URL de base du coffre de clés géré par le client

cmk_key_name
<xref:str>
valeur par défaut: None

nom de la clé gérée par le client.

cmk_key_version
<xref:str>
valeur par défaut: None

version de la clé gérée par le client.

vnet_name
<xref:str>
valeur par défaut: None

nom du réseau virtuel.

subnet_name
<xref:str>
valeur par défaut: None

nom du sous-réseau dans le réseau virtuel.

Retours

Objet de configuration à utiliser lors du déploiement d’un objet WebService.

Type de retour

Exceptions

get_token

Récupère le jeton d’authentification pour ce service Web, limité à l’utilisateur actuel.

Notes

Non implémenté.

get_token()

Retours

Le jeton d’authentification pour ce service Web et le moment où il doit être actualisé après.

Type de retour

<xref:str>, <xref:datetime>

remove_tags

Supprimez les clés spécifiées du dictionnaire de balises WebService.

remove_tags(tags)

Paramètres

tags
list[<xref:str>]

Liste des clés à supprimer.

run

Appelez ce service Web avec l’entrée fournie.

run(input_data)

Paramètres

input_data
<xref:varies>

Entrée avec laquelle appeler le service Web.

Retours

Résultat de l’appel du service Web.

Type de retour

<xref:dict>

Exceptions

serialize

Convertissez ce service Web en dictionnaire JSON sérialisé.

serialize()

Retours

Représentation JSON de cet objet WebService.

Type de retour

<xref:dict>

update

Mettez à jour le service Web avec les propriétés fournies.

Les valeurs laissées en aucune demeureront inchangées dans ce service 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)

Paramètres

image
Image
valeur par défaut: None

Nouvelle image à déployer sur le service Web.

tags
<xref:dict>[<xref:str>, <xref:str>]
valeur par défaut: None

Dictionnaire de balises de valeur de clé à attribuer à ce service Web. Va remplacer les balises existantes.

properties
<xref:dict>[<xref:str>, <xref:str>]
valeur par défaut: None

Dictionnaire de propriétés de valeur de clé à ajouter au dictionnaire de propriétés existant.

description
<xref:str>
valeur par défaut: None

Description pour fournir ce service Web.

auth_enabled
<xref:bool>
valeur par défaut: None

Activez ou désactivez auth pour ce service Web.

ssl_enabled
<xref:bool>
valeur par défaut: None

Indique s’il faut activer ou pas SSL pour ce service web.

ssl_cert_pem_file
<xref:str>
valeur par défaut: None

Le fichier de certificat est nécessaire si le protocole SSL est activé.

ssl_key_pem_file
<xref:str>
valeur par défaut: None

Fichier de clé nécessaire si le protocole SSL est activé.

ssl_cname
<xref:str>
valeur par défaut: None

CNAME pour si SSL est activé.

enable_app_insights
<xref:bool>
valeur par défaut: None

Indique s’il faut activer ou pas AppInsights pour ce service web.

models
list[Model]
valeur par défaut: None

Liste d’objets de modèle à empaqueter dans le service mis à jour.

inference_config
InferenceConfig
valeur par défaut: None

Objet InferenceConfig utilisé pour fournir les propriétés de déploiement de modèle requises.

Type de retour

<xref:None>