AciWebservice Klas

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

Er wordt een geïmplementeerde service 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 dat overeenkomt met het specifieke type van het opgehaalde webserviceobject.

Constructor

AciWebservice(workspace, name)

Parameters

Name	Description
workspace Vereist	Workspace 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:

deploy methode van de Model voor modellen die al zijn geregistreerd in de werkruimte.
deploy_from_image methode van Webservice.
deploy_from_model methode voor Webservice modellen die al zijn geregistreerd in de werkruimte. Met deze methode maakt u een installatiekopieën.
deploy methode van de Webservice, waarmee een model wordt geregistreerd en een installatiekopieën wordt 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 als alleen-lezen worden beschouwd. Het wijzigen van de waarden wordt niet weergegeven in het bijbehorende cloudobject.

Variabelen

Name	Description
enable_app_insights	bool Of Logboekregistratie van AppInsights al dan niet is ingeschakeld voor de webservice.
cname	str De cname voor de webservice.
container_resource_requirements	ContainerResourceRequirements De vereisten voor containerresources voor de webservice.
encryption_properties	EncryptionProperties De versleutelingseigenschappen voor de webservice.
vnet_configuration	VnetConfiguration De eigenschappen van het virtuele netwerk voor de webservice moeten worden gemaakt en geleverd door de gebruiker.
azureml.core.webservice.AciWebservice.location	str De locatie waarop de webservice is 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	bool Of SSL al dan niet is ingeschakeld voor de webservice
public_fqdn	str De openbare FQDN voor de webservice
environment	Environment Het omgevingsobject dat is gebruikt om de webservice te maken
azureml.core.webservice.AciWebservice.models	list[Model] 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	Voeg sleutel-waardeparen toe aan de eigenschappenwoordenlijst van deze webservice.
add_tags	Voeg sleutel-waardeparen toe aan de tagswoordenlijst van deze webservice.
deploy_configuration	Maak een configuratieobject voor het implementeren van een AciWebservice.
get_token	Haal het verificatietoken voor deze webservice op, met het bereik van de huidige gebruiker. Opmerking Niet geïmplementeerd.
remove_tags	Verwijder de opgegeven sleutels uit de woordenlijst van deze webservice met tags.
run	Roep deze webservice aan met de opgegeven invoer.
serialize	Converteer deze webservice naar een geserialiseerde JSON-woordenlijst.
update	Werk de webservice bij met opgegeven eigenschappen. De waarden blijven ongewijzigd in deze webservice.

add_properties

Voeg sleutel-waardeparen toe aan de eigenschappenwoordenlijst van deze webservice.

add_properties(properties)

Parameters

Name	Description
properties Vereist	dict[str, str] De woordenlijst met eigenschappen die u wilt toevoegen.

add_tags

Voeg sleutel-waardeparen toe aan de tagswoordenlijst van deze webservice.

add_tags(tags)

Parameters

Name	Description
tags Vereist	dict[str, str] De woordenlijst met tags die u wilt toevoegen.

Uitzonderingen

Type	Description
WebserviceException

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	float Het aantal CPU-kernen dat moet worden toegewezen voor deze webservice. Kan een decimaal getal zijn. Standaard ingesteld op 0.1 Default value: None
memory_gb	float De hoeveelheid geheugen (in GB) die moet worden toegewezen voor deze webservice. Kan een decimaal getal zijn. Standaard ingesteld op 0,5 Default value: None
tags	dict[str, str] Een woordenlijst met sleutelwaardetags om deze webservice te geven. Default value: None
properties	dict[str, str] Een woordenlijst met sleutelwaarde-eigenschappen om deze webservice te geven. Deze eigenschappen kunnen niet worden gewijzigd na de implementatie, maar nieuwe sleutelwaardeparen kunnen worden toegevoegd. Default value: None
description	str Een beschrijving om deze webservice te geven. 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	bool Hiermee wordt aangegeven of verificatie voor deze webservice al dan niet moet worden ingeschakeld. De standaardwaarde is False. Default value: None
ssl_enabled	bool Hiermee wordt aangegeven of SSL voor deze webservice al dan niet moet worden ingeschakeld. De standaardwaarde is False. Default value: None
enable_app_insights	bool Of u AppInsights al dan niet wilt inschakelen voor deze webservice. De standaardwaarde is 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 er geen uniek DNS-naamlabel is opgegeven, 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	bool Of modelgegevensverzameling al dan niet is ingeschakeld voor de webservice. Default value: None
cmk_vault_base_url	str basis-URL voor 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 binnen virtueel netwerk. Default value: None

Retouren

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

Uitzonderingen

Type	Description
WebserviceException

get_token

Haal het verificatietoken voor deze webservice op, met het bereik van de huidige gebruiker.

Opmerking

Niet geïmplementeerd.

get_token()

Retouren

Type	Description
str, datetime	Het verificatietoken voor deze webservice en wanneer het moet worden vernieuwd.

Uitzonderingen

Type	Description
azureml.exceptions.NotImplementedError

remove_tags

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

remove_tags(tags)

Parameters

Name	Description
tags Vereist	list[str] De lijst met sleutels die u wilt verwijderen.

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
dict	Het resultaat van het aanroepen van de webservice.

Uitzonderingen

Type	Description
WebserviceException

serialize

Converteer deze webservice naar een geserialiseerde JSON-woordenlijst.

serialize()

Retouren

Type	Description
dict	De JSON-weergave van dit webserviceobject.

update

Werk de webservice bij met opgegeven eigenschappen.

De waarden 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	Image Een nieuwe installatiekopieën die in de webservice moeten worden geïmplementeerd. Default value: None
tags	dict[str, str] Een woordenlijst met sleutelwaardetags om deze webservice te geven. Vervangt bestaande tags. Default value: None
properties	dict[str, str] Een woordenlijst met sleutelwaarde-eigenschappen die u wilt toevoegen aan de bestaande woordenlijst met eigenschappen. Default value: None
description	str Een beschrijving om deze webservice te geven. Default value: None
auth_enabled	bool Verificatie voor deze webservice in- of uitschakelen. Default value: None
ssl_enabled	bool Hiermee wordt aangegeven of SSL voor deze webservice al dan niet moet worden ingeschakeld. 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	bool Of u AppInsights al dan niet wilt inschakelen voor deze webservice. Default value: None
models	list[Model] Een lijst met modelobjecten die in de bijgewerkte service moeten worden verpakt. Default value: None
inference_config	InferenceConfig Een InferenceConfig-object dat wordt gebruikt om de vereiste modelimplementatie-eigenschappen op te geven. Default value: None

Retouren

Type	Description
None

Delen via

AciWebservice Klas

Constructor

Parameters

Opmerkingen

Variabelen

Methoden

add_properties

Parameters

add_tags

Parameters

Uitzonderingen

deploy_configuration

Parameters

Retouren

Uitzonderingen

get_token

Retouren

Uitzonderingen

remove_tags

Parameters

run

Parameters

Retouren

Uitzonderingen

serialize

Retouren

update

Parameters

Retouren

Feedback