Delen via


AciWebservice Klas

Vertegenwoordigt een machine learning-model dat is geïmplementeerd als een webservice-eindpunt op Azure Container Instances.

Een geïmplementeerde service wordt gemaakt op basis van een model, script en bijbehorende bestanden. De resulterende webservice is een HTTP-eindpunt met gelijke taakverdeling met een REST API. U kunt gegevens naar deze API verzenden en de voorspelling ontvangen die door het model wordt geretourneerd.

Zie Een model implementeren in Azure Container Instances voor meer informatie.

Initialiseer het webservice-exemplaar.

De webserviceconstructor haalt een cloudweergave op van een webserviceobject dat is gekoppeld aan de opgegeven werkruimte. Er wordt een exemplaar van een onderliggende klasse geretourneerd die overeenkomt met het specifieke type van het opgehaalde webserviceobject.

Overname
AciWebservice

Constructor

AciWebservice(workspace, name)

Parameters

Name Description
workspace
Vereist

Het werkruimteobject met het webserviceobject dat moet worden opgehaald.

name
Vereist
str

De naam van het webserviceobject dat moet worden opgehaald.

Opmerkingen

Het aanbevolen implementatiepatroon is om een implementatieconfiguratieobject te maken met de deploy_configuration methode en dit vervolgens te gebruiken met de deploy methode van de Model klasse, zoals hieronder wordt weergegeven.


   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)

Er zijn een aantal manieren om een model als webservice te implementeren, waaronder met de:

  • deploy van de Model for-modellen die al zijn geregistreerd in de werkruimte.

  • deploy_from_image methode van Webservice.

  • deploy_from_model methode van Webservice voor modellen die al zijn geregistreerd in de werkruimte. Met deze methode wordt een installatiekopieën gemaakt.

  • deploy van de Webservice, waarmee een model wordt geregistreerd en een installatiekopieën worden gemaakt.

Zie voor meer informatie over het werken met webservices

De sectie Variabelen bevat kenmerken van een lokale weergave van het cloud-AciWebservice-object. Deze variabelen moeten worden beschouwd als alleen-lezen. Het wijzigen van de waarden wordt niet weergegeven in het bijbehorende cloudobject.

Variabelen

Name Description
enable_app_insights

Of AppInsights-logboekregistratie is ingeschakeld voor de webservice.

cname
str

De cname voor de webservice.

container_resource_requirements

De resourcevereisten voor de container voor de webservice.

encryption_properties

De versleutelingseigenschappen voor de webservice.

vnet_configuration

De eigenschappen van het virtuele netwerk voor de configuratie van de webservice moeten door de gebruiker worden gemaakt en opgegeven.

azureml.core.webservice.AciWebservice.location
str

De locatie waarop de webservice wordt geïmplementeerd.

public_ip
str

Het openbare IP-adres van de webservice.

azureml.core.webservice.AciWebservice.scoring_uri
str

Het score-eindpunt voor de webservice

ssl_enabled

Of SSL al dan niet is ingeschakeld voor de webservice

public_fqdn
str

De openbare FQDN voor de webservice

environment

Het omgevingsobject dat is gebruikt om de webservice te maken

azureml.core.webservice.AciWebservice.models

Een lijst met modellen die zijn geïmplementeerd in de webservice

azureml.core.webservice.AciWebservice.swagger_uri
str

Het swagger-eindpunt voor de webservice

Methoden

add_properties

Sleutelwaardeparen toevoegen aan de woordenlijst met eigenschappen van deze webservice.

add_tags

Voeg sleutelwaardeparen toe aan de woordenlijst met tags van deze webservice.

deploy_configuration

Maak een configuratieobject voor het implementeren van een AciWebservice.

get_token

Verificatietoken ophalen voor deze webservice, met het bereik van de huidige gebruiker.

Notitie

Niet geïmplementeerd.

remove_tags

Verwijder de opgegeven sleutels uit de woordenlijst met tags van deze webservice.

run

Roep deze webservice aan met de opgegeven invoer.

serialize

Converteer deze webservice naar een geserialiseerde JSON-woordenlijst.

update

Werk de webservice bij met de opgegeven eigenschappen.

Waarden die worden overgelaten als Geen, blijven ongewijzigd in deze webservice.

add_properties

Sleutelwaardeparen toevoegen aan de woordenlijst met eigenschappen van deze webservice.

add_properties(properties)

Parameters

Name Description
properties
Vereist

De woordenlijst met eigenschappen die u wilt toevoegen.

add_tags

Voeg sleutelwaardeparen toe aan de woordenlijst met tags van deze webservice.

add_tags(tags)

Parameters

Name Description
tags
Vereist

De woordenlijst met tags die u wilt toevoegen.

Uitzonderingen

Type Description

deploy_configuration

Maak een configuratieobject voor het implementeren van een 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)

Parameters

Name Description
cpu_cores

Het aantal CPU-kernen dat voor deze webservice moet worden toegewezen. Kan een decimaal getal zijn. Standaard ingesteld op 0.1

Default value: None
memory_gb

De hoeveelheid geheugen (in GB) die voor deze webservice moet worden toegewezen. Kan een decimaal getal zijn. De standaardwaarde is 0,5

Default value: None
tags

Een woordenlijst met sleutelwaardelabels voor deze webservice.

Default value: None
properties

Een woordenlijst met sleutelwaarde-eigenschappen voor deze webservice. Deze eigenschappen kunnen niet worden gewijzigd na de implementatie, maar er kunnen wel nieuwe sleutelwaardeparen worden toegevoegd.

Default value: None
description
str

Een beschrijving voor deze webservice.

Default value: None
location
str

De Azure-regio om deze webservice in te implementeren. Als deze niet wordt opgegeven, wordt de werkruimtelocatie gebruikt. Zie Producten per regio voor meer informatie over beschikbare regio's.

Default value: None
auth_enabled

Of verificatie voor deze webservice al dan niet moet worden ingeschakeld. Standaard ingesteld op False.

Default value: None
ssl_enabled

Of SSL al dan niet moet worden ingeschakeld voor deze webservice. Standaard ingesteld op False.

Default value: None
enable_app_insights

Of AppInsights al dan niet moet worden ingeschakeld voor deze webservice. Standaard ingesteld op False.

Default value: None
ssl_cert_pem_file
str

Het certificaatbestand dat nodig is als SSL is ingeschakeld.

Default value: None
ssl_key_pem_file
str

Het sleutelbestand dat nodig is als SSL is ingeschakeld.

Default value: None
ssl_cname
str

De cname voor als SSL is ingeschakeld.

Default value: None
dns_name_label
str

Het DNS-naamlabel voor het score-eindpunt. Als u niet opgeeft, wordt er een uniek DNS-naamlabel gegenereerd voor het score-eindpunt.

Default value: None
primary_key
str

Een primaire verificatiesleutel die moet worden gebruikt voor deze webservice.

Default value: None
secondary_key
str

Een secundaire verificatiesleutel die moet worden gebruikt voor deze webservice.

Default value: None
collect_model_data

Hiermee wordt aangegeven of modelgegevensverzameling voor de webservice moet worden ingeschakeld.

Default value: None
cmk_vault_base_url
str

basis-URL van door de klant beheerde sleutelkluis

Default value: None
cmk_key_name
str

door de klant beheerde sleutelnaam.

Default value: None
cmk_key_version
str

door de klant beheerde sleutelversie.

Default value: None
vnet_name
str

naam van virtueel netwerk.

Default value: None
subnet_name
str

subnetnaam in virtueel netwerk.

Default value: None

Retouren

Type Description

Een configuratieobject dat moet worden gebruikt bij het implementeren van een webserviceobject.

Uitzonderingen

Type Description

get_token

Verificatietoken ophalen voor deze webservice, met het bereik van de huidige gebruiker.

Notitie

Niet geïmplementeerd.

get_token()

Retouren

Type Description

Het verificatietoken voor deze webservice en wanneer het daarna moet worden vernieuwd.

Uitzonderingen

Type Description
azureml.exceptions.NotImplementedError

remove_tags

Verwijder de opgegeven sleutels uit de woordenlijst met tags van deze webservice.

remove_tags(tags)

Parameters

Name Description
tags
Vereist

De lijst met sleutels die moeten worden verwijderd.

run

Roep deze webservice aan met de opgegeven invoer.

run(input_data)

Parameters

Name Description
input_data
Vereist
<xref:varies>

De invoer waarmee de webservice moet worden aangeroepen.

Retouren

Type Description

Het resultaat van het aanroepen van de webservice.

Uitzonderingen

Type Description

serialize

Converteer deze webservice naar een geserialiseerde JSON-woordenlijst.

serialize()

Retouren

Type Description

De JSON-weergave van dit webserviceobject.

update

Werk de webservice bij met de opgegeven eigenschappen.

Waarden die worden overgelaten als Geen, blijven ongewijzigd in deze 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)

Parameters

Name Description
image

Een nieuwe installatiekopieën voor implementatie in de webservice.

Default value: None
tags

Een woordenlijst met sleutelwaardelabels voor deze webservice. Vervangt bestaande tags.

Default value: None
properties

Een woordenlijst met sleutelwaarde-eigenschappen om toe te voegen aan bestaande eigenschappenwoordenlijst.

Default value: None
description
str

Een beschrijving voor deze webservice.

Default value: None
auth_enabled

Verificatie voor deze webservice in- of uitschakelen.

Default value: None
ssl_enabled

Of SSL al dan niet moet worden ingeschakeld voor deze webservice.

Default value: None
ssl_cert_pem_file
str

Het certificaatbestand dat nodig is als SSL is ingeschakeld.

Default value: None
ssl_key_pem_file
str

Het sleutelbestand dat nodig is als SSL is ingeschakeld.

Default value: None
ssl_cname
str

De cname voor als SSL is ingeschakeld.

Default value: None
enable_app_insights

Of AppInsights al dan niet moet worden ingeschakeld voor deze webservice.

Default value: None
models

Een lijst met modelobjecten die in de bijgewerkte service moeten worden verpakt.

Default value: None
inference_config

Een InferenceConfig-object dat wordt gebruikt om de vereiste modelimplementatie-eigenschappen te bieden.

Default value: None

Retouren

Type Description