AciWebservice Klass

Representerar en maskininlärningsmodell som distribuerats som en webbtjänstslutpunkt på Azure Container Instances.

En distribuerad tjänst skapas från en modell, ett skript och associerade filer. Den resulterande webbtjänsten är en belastningsbalanserad HTTP-slutpunkt med ett REST-API. Du kan skicka data till det här API:et och ta emot förutsägelsen som returneras av modellen.

Mer information finns i Distribuera en modell till Azure Container Instances.

Initiera Webservice-instansen.

Webbtjänstkonstruktorn hämtar en molnrepresentation av ett webbtjänstobjekt som är associerat med den angivna arbetsytan. Den returnerar en instans av en underordnad klass som motsvarar den specifika typen av det hämtade webbtjänstobjektet.

Konstruktor

AciWebservice(workspace, name)

Parametrar

Name	Description
workspace Obligatorisk	Workspace Arbetsyteobjektet som innehåller webbtjänstobjektet som ska hämtas.
name Obligatorisk	str Namnet på det Webservice-objekt som ska hämtas.

Kommentarer

Det rekommenderade distributionsmönstret är att skapa ett distributionskonfigurationsobjekt med deploy_configuration -metoden och sedan använda det med deploy metoden för Model klassen enligt nedan.


   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)

Det finns ett antal sätt att distribuera en modell som en webbtjänst, bland annat med:

deploy metoden för för modeller som Model redan har registrerats på arbetsytan.
deploy_from_image -metod för Webservice.
deploy_from_model Webservice metod för modeller som redan har registrerats på arbetsytan. Den här metoden skapar en avbildning.
deploy -metoden för Webservice, som registrerar en modell och skapar en avbildning.

Information om hur du arbetar med webbtjänster finns i

Avsnittet Variabler visar attribut för en lokal representation av molnobjektet AciWebservice. Dessa variabler bör betraktas som skrivskyddade. Att ändra deras värden återspeglas inte i motsvarande molnobjekt.

Variabler

Name	Description
enable_app_insights	bool Om AppInsights-loggning är aktiverad för webbtjänsten eller inte.
cname	str Cname för webbtjänsten.
container_resource_requirements	ContainerResourceRequirements Kraven för containerresursen för webbtjänsten.
encryption_properties	EncryptionProperties Krypteringsegenskaperna för webbtjänsten.
vnet_configuration	VnetConfiguration Egenskaperna för det virtuella nätverket för webbtjänsten, konfigurationen ska skapas och tillhandahållas av användaren.
azureml.core.webservice.AciWebservice.location	str Platsen som webbtjänsten distribueras till.
public_ip	str Webbtjänstens offentliga IP-adress.
azureml.core.webservice.AciWebservice.scoring_uri	str Slutpunkten för bedömning för webbtjänsten
ssl_enabled	bool Om SSL är aktiverat för webbtjänsten eller inte
public_fqdn	str Det offentliga fullständiga domännamnet för webbtjänsten
environment	Environment Miljöobjektet som användes för att skapa webbtjänsten
azureml.core.webservice.AciWebservice.models	list[Model] En lista över modeller som distribuerats till webbtjänsten
azureml.core.webservice.AciWebservice.swagger_uri	str Swagger-slutpunkten för webbtjänsten

Metoder

add_properties	Lägg till nyckelvärdepar i den här webbtjänstens egenskapsordlista.
add_tags	Lägg till nyckelvärdepar i ordlistan för den här webbtjänstens taggar.
deploy_configuration	Skapa ett konfigurationsobjekt för att distribuera en AciWebservice.
get_token	Hämta autentiseringstoken för den här webbtjänsten, som är begränsad till den aktuella användaren. Anmärkning Inte implementerad.
remove_tags	Ta bort de angivna nycklarna från den här webbtjänstens ordlista med taggar.
run	Anropa den här webbtjänsten med de angivna indata.
serialize	Konvertera den här webbtjänsten till en JSON-serialiserad ordlista.
update	Uppdatera webbtjänsten med angivna egenskaper. Värden kvar som Ingen förblir oförändrade i den här webbtjänsten.

add_properties

Lägg till nyckelvärdepar i den här webbtjänstens egenskapsordlista.

add_properties(properties)

Parametrar

Name	Description
properties Obligatorisk	dict[str, str] Ordlistan med egenskaper som ska läggas till.

add_tags

Lägg till nyckelvärdepar i ordlistan för den här webbtjänstens taggar.

add_tags(tags)

Parametrar

Name	Description
tags Obligatorisk	dict[str, str] Ordlistan med taggar som ska läggas till.

Undantag

Typ	Description
WebserviceException

deploy_configuration

Skapa ett konfigurationsobjekt för att distribuera en 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)

Parametrar

Name	Description
cpu_cores	float Antalet CPU-kärnor som ska allokeras för den här webbtjänsten. Kan vara en decimal. Standardvärdet är 0,1 Standardvärde: None
memory_gb	float Mängden minne (i GB) som ska allokeras för den här webbtjänsten. Kan vara en decimal. Standardvärdet är 0,5 Standardvärde: None
tags	dict[str, str] En ordlista med nyckelvärdestaggar för att ge den här webbtjänsten. Standardvärde: None
properties	dict[str, str] En ordlista med nyckelvärdesegenskaper som ger den här webbtjänsten. Dessa egenskaper kan inte ändras efter distributionen, men nya nyckelvärdepar kan läggas till. Standardvärde: None
description	str En beskrivning för att ge den här webbtjänsten. Standardvärde: None
location	str Den Azure-region som den här webbtjänsten ska distribueras till. Om den inte anges används arbetsytans plats. Mer information om tillgängliga regioner finns i Produkter efter region. Standardvärde: None
auth_enabled	bool Om du vill aktivera autentisering för den här webbtjänsten eller inte. Standardvärdet är False. Standardvärde: None
ssl_enabled	bool Om du vill aktivera SSL för den här webbtjänsten eller inte. Standardvärdet är False. Standardvärde: None
enable_app_insights	bool Om du vill aktivera AppInsights för den här webbtjänsten eller inte. Standardvärdet är False. Standardvärde: None
ssl_cert_pem_file	str Certifikatfilen behövs om SSL är aktiverat. Standardvärde: None
ssl_key_pem_file	str Nyckelfilen behövs om SSL är aktiverat. Standardvärde: None
ssl_cname	str Cname för om SSL är aktiverat. Standardvärde: None
dns_name_label	str DNS-namnetiketten för bedömningsslutpunkten. Om den inte anges genereras en unik DNS-namnetikett för bedömningsslutpunkten. Standardvärde: None
primary_key	str En primär autentiseringsnyckel som ska användas för den här webbtjänsten. Standardvärde: None
secondary_key	str En sekundär autentiseringsnyckel som ska användas för den här webbtjänsten. Standardvärde: None
collect_model_data	bool Om du vill aktivera datainsamling av modelldata för webbtjänsten eller inte. Standardvärde: None
cmk_vault_base_url	str kundhanterad key vault-bas-URL Standardvärde: None
cmk_key_name	str kundhanterat nyckelnamn. Standardvärde: None
cmk_key_version	str kundhanterad nyckelversion. Standardvärde: None
vnet_name	str namn på virtuellt nätverk. Standardvärde: None
subnet_name	str undernätsnamn i det virtuella nätverket. Standardvärde: None

Returer

Typ	Description
AciServiceDeploymentConfiguration	Ett konfigurationsobjekt som ska användas när ett webbtjänstobjekt distribueras.

Undantag

Typ	Description
WebserviceException

get_token

Hämta autentiseringstoken för den här webbtjänsten, som är begränsad till den aktuella användaren.

Anmärkning

Inte implementerad.

get_token()

Returer

Typ	Description
str, datetime	Autentiseringstoken för den här webbtjänsten och när den ska uppdateras efter.

Undantag

Typ	Description
azureml.exceptions.NotImplementedError

remove_tags

Ta bort de angivna nycklarna från den här webbtjänstens ordlista med taggar.

remove_tags(tags)

Parametrar

Name	Description
tags Obligatorisk	list[str] Listan med nycklar att ta bort.

run

Anropa den här webbtjänsten med de angivna indata.

run(input_data)

Parametrar

Name	Description
input_data Obligatorisk	<xref:varies> De indata som webbtjänsten ska anropas med.

Returer

Typ	Description
dict	Resultatet av att anropa webbtjänsten.

Undantag

Typ	Description
WebserviceException

serialize

Konvertera den här webbtjänsten till en JSON-serialiserad ordlista.

serialize()

Returer

Typ	Description
dict	JSON-representationen av det här webbtjänstobjektet.

update

Uppdatera webbtjänsten med angivna egenskaper.

Värden kvar som Ingen förblir oförändrade i den här webbtjänsten.

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)

Parametrar

Name	Description
image	Image En ny avbildning som ska distribueras till webbtjänsten. Standardvärde: None
tags	dict[str, str] En ordlista med nyckelvärdestaggar för att ge den här webbtjänsten. Ersätter befintliga taggar. Standardvärde: None
properties	dict[str, str] En ordlista med nyckelvärdesegenskaper som ska läggas till i en befintlig egenskapsordlista. Standardvärde: None
description	str En beskrivning för att ge den här webbtjänsten. Standardvärde: None
auth_enabled	bool Aktivera eller inaktivera autentisering för den här webbtjänsten. Standardvärde: None
ssl_enabled	bool Om du vill aktivera SSL för den här webbtjänsten eller inte. Standardvärde: None
ssl_cert_pem_file	str Certifikatfilen behövs om SSL är aktiverat. Standardvärde: None
ssl_key_pem_file	str Nyckelfilen behövs om SSL är aktiverat. Standardvärde: None
ssl_cname	str Cname för om SSL är aktiverat. Standardvärde: None
enable_app_insights	bool Om du vill aktivera AppInsights för den här webbtjänsten eller inte. Standardvärde: None
models	list[Model] En lista över modellobjekt som ska paketeras i den uppdaterade tjänsten. Standardvärde: None
inference_config	InferenceConfig Ett InferenceConfig-objekt som används för att tillhandahålla de nödvändiga modelldistributionsegenskaperna. Standardvärde: None

Returer

Typ	Description
None

Feedback

Var den här sidan till hjälp?

Dela via

AciWebservice Klass

Konstruktor

Parametrar

Kommentarer

Variabler

Metoder

add_properties

Parametrar

add_tags

Parametrar

Undantag

deploy_configuration

Parametrar

Returer

Undantag

get_token

Returer

Undantag

remove_tags

Parametrar

run

Parametrar

Returer

Undantag

serialize

Returer

update

Parametrar

Returer

Feedback