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
- workspace
- Workspace
Het werkruimteobject met 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
- enable_app_insights
- bool
Of AppInsights-logboekregistratie is ingeschakeld voor de webservice.
- cname
- str
De cname voor de webservice.
- container_resource_requirements
- ContainerResourceRequirements
De resourcevereisten voor de container voor de webservice.
- encryption_properties
- EncryptionProperties
De versleutelingseigenschappen voor de webservice.
- vnet_configuration
- VnetConfiguration
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
- 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
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
add_tags
Voeg sleutelwaardeparen toe aan de woordenlijst met tags van deze webservice.
add_tags(tags)
Parameters
Uitzonderingen
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
- cpu_cores
- float
Het aantal CPU-kernen dat voor deze webservice moet worden toegewezen. Kan een decimaal getal zijn. Standaard ingesteld op 0.1
- memory_gb
- float
De hoeveelheid geheugen (in GB) die voor deze webservice moet worden toegewezen. Kan een decimaal getal zijn. De standaardwaarde is 0,5
Een woordenlijst met sleutelwaardelabels voor deze webservice.
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.
- 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.
- auth_enabled
- bool
Of verificatie voor deze webservice al dan niet moet worden ingeschakeld. Standaard ingesteld op False.
- ssl_enabled
- bool
Of SSL al dan niet moet worden ingeschakeld voor deze webservice. Standaard ingesteld op False.
- enable_app_insights
- bool
Of AppInsights al dan niet moet worden ingeschakeld voor deze webservice. Standaard ingesteld op False.
- ssl_cert_pem_file
- str
Het certificaatbestand dat nodig is als SSL is ingeschakeld.
- 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.
- primary_key
- str
Een primaire verificatiesleutel die moet worden gebruikt voor deze webservice.
- secondary_key
- str
Een secundaire verificatiesleutel die moet worden gebruikt voor deze webservice.
- collect_model_data
- bool
Hiermee wordt aangegeven of modelgegevensverzameling voor de webservice moet worden ingeschakeld.
Retouren
Een configuratieobject dat moet worden gebruikt bij het implementeren van een webserviceobject.
Retourtype
Uitzonderingen
get_token
Verificatietoken ophalen voor deze webservice, met het bereik van de huidige gebruiker.
Notitie
Niet geïmplementeerd.
get_token()
Retouren
Het verificatietoken voor deze webservice en wanneer het daarna moet worden vernieuwd.
Retourtype
Uitzonderingen
remove_tags
Verwijder de opgegeven sleutels uit de woordenlijst met tags van deze webservice.
remove_tags(tags)
Parameters
run
Roep deze webservice aan met de opgegeven invoer.
run(input_data)
Parameters
- input_data
- <xref:varies>
De invoer waarmee de webservice moet worden aangeroepen.
Retouren
Het resultaat van het aanroepen van de webservice.
Retourtype
Uitzonderingen
serialize
Converteer deze webservice naar een geserialiseerde JSON-woordenlijst.
serialize()
Retouren
De JSON-weergave van dit webserviceobject.
Retourtype
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
- image
- Image
Een nieuwe installatiekopieën voor implementatie in de webservice.
Een woordenlijst met sleutelwaardelabels voor deze webservice. Vervangt bestaande tags.
Een woordenlijst met sleutelwaarde-eigenschappen om toe te voegen aan bestaande eigenschappenwoordenlijst.
- ssl_enabled
- bool
Of SSL al dan niet moet worden ingeschakeld voor deze webservice.
- ssl_cert_pem_file
- str
Het certificaatbestand dat nodig is als SSL is ingeschakeld.
- enable_app_insights
- bool
Of AppInsights al dan niet moet worden ingeschakeld voor deze webservice.
Een lijst met modelobjecten die in de bijgewerkte service moeten worden verpakt.
- inference_config
- InferenceConfig
Een InferenceConfig-object dat wordt gebruikt om de vereiste modelimplementatie-eigenschappen te bieden.
Retourtype
Feedback
https://aka.ms/ContentUserFeedback.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie:Feedback verzenden en weergeven voor