Delen via

AciWebservice Klas

  • Referentie

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
Webservice
AciWebservice

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 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
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
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

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
dict[str, str]

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
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 voor deze webservice moet worden toegewezen. Kan een decimaal getal zijn. Standaard ingesteld op 0.1

Default value: None
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

Default value: None
tags
dict[str, str]

Een woordenlijst met sleutelwaardelabels voor deze webservice.

Default value: None
properties
dict[str, str]

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
bool

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

Default value: None
ssl_enabled
bool

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

Default value: None
enable_app_insights
bool

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
bool

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
AciServiceDeploymentConfiguration

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

Uitzonderingen

Type Description
WebserviceException

get_token

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

Notitie

Niet geïmplementeerd.

get_token()

Retouren

Type Description
str, datetime

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
list[str]

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
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 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
Image

Een nieuwe installatiekopieën voor implementatie in de webservice.

Default value: None
tags
dict[str, str]

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

Default value: None
properties
dict[str, str]

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
bool

Verificatie voor deze webservice in- of uitschakelen.

Default value: None
ssl_enabled
bool

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
bool

Of AppInsights al dan niet moet worden ingeschakeld 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 te bieden.

Default value: None

Retouren

Type Description
None