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 få 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.
- Arv
-
AciWebservice
Konstruktor
AciWebservice(workspace, name)
Parametrar
- workspace
- Workspace
Arbetsyteobjektet som innehåller webbtjänstobjektet 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 i 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 är registrerade på arbetsytan.deploy_from_image
-metod för Webservice.deploy_from_model
Webservice metoden för för modeller som redan är registrerade 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
Konsumera en Azure Machine Learning-modell som distribuerats som en webbtjänst
Se Övervaka och samla in data från webbtjänstslutpunkter i ML
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
- enable_app_insights
- bool
Om AppInsights-loggning är aktiverat 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
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 nyckel/värde-par 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, begränsad till den aktuella användaren. Anteckning Inte implementerat. |
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 angivna indata. |
serialize |
Konvertera den här webbtjänsten till en serialiserad JSON-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
add_tags
Lägg till nyckel/värde-par i ordlistan för den här webbtjänstens taggar.
add_tags(tags)
Parametrar
Undantag
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
- 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
- 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
En ordlista med nyckelvärdestaggar som ger den här webbtjänsten.
En ordlista med nyckelvärdesegenskaper som ger den här webbtjänsten. Dessa egenskaper kan inte ändras efter distributionen, men nya nyckel/värde-par kan läggas till.
- location
- str
Den Azure-region som den här webbtjänsten ska distribueras till. Om inget anges används arbetsytans plats. Mer information om tillgängliga regioner finns i Produkter efter region.
- auth_enabled
- bool
Om du vill aktivera autentisering för den här webbtjänsten eller inte. Standardvärdet är False.
- ssl_enabled
- bool
Om du vill aktivera SSL för den här webbtjänsten eller inte. Standardvärdet är False.
- enable_app_insights
- bool
Om du vill aktivera AppInsights för den här webbtjänsten eller inte. Standardvärdet är False.
- dns_name_label
- str
DNS-namnetiketten för bedömningsslutpunkten. Om inget anges genereras en unik DNS-namnetikett för bedömningsslutpunkten.
- primary_key
- str
En primär autentiseringsnyckel som ska användas för den här webbtjänsten.
- secondary_key
- str
En sekundär autentiseringsnyckel som ska användas för den här webbtjänsten.
- collect_model_data
- bool
Om du vill aktivera modelldatainsamling för webbtjänsten eller inte.
Returer
Ett konfigurationsobjekt som ska användas när ett webbtjänstobjekt distribueras.
Returtyp
Undantag
get_token
Hämta autentiseringstoken för den här webbtjänsten, begränsad till den aktuella användaren.
Anteckning
Inte implementerat.
get_token()
Returer
Autentiseringstoken för den här webbtjänsten och när den ska uppdateras efter.
Returtyp
Undantag
remove_tags
Ta bort de angivna nycklarna från den här webbtjänstens ordlista med taggar.
remove_tags(tags)
Parametrar
run
Anropa den här webbtjänsten med angivna indata.
run(input_data)
Parametrar
- input_data
- <xref:varies>
De indata som webbtjänsten ska anropas med.
Returer
Resultatet av att anropa webbtjänsten.
Returtyp
Undantag
serialize
Konvertera den här webbtjänsten till en serialiserad JSON-ordlista.
serialize()
Returer
JSON-representationen av det här webbtjänstobjektet.
Returtyp
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
En ordlista med nyckelvärdestaggar som ger den här webbtjänsten. Ersätter befintliga taggar.
En ordlista med nyckelvärdesegenskaper som ska läggas till i den befintliga egenskapsordlistan.
- auth_enabled
- bool
Aktivera eller inaktivera autentisering för den här webbtjänsten.
- enable_app_insights
- bool
Om du vill aktivera AppInsights för den här webbtjänsten eller inte.
En lista över modellobjekt som ska paketera i den uppdaterade tjänsten.
- inference_config
- InferenceConfig
Ett InferenceConfig-objekt som används för att tillhandahålla de nödvändiga modelldistributionsegenskaperna.
Returtyp
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för