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

Webservice

AciWebservice

Constructor

AciWebservice(workspace, name)

Parameters

workspace

Workspace

Vereist

Het werkruimteobject met het webserviceobject dat moet worden opgehaald.

name

str

Vereist

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

• Een Azure Machine Learning-model gebruiken dat als een webservice is geïmplementeerd

• Gegevens van ML-webservice-eindpunten bewaken en verzamelen

• Problemen met implementatie oplossen

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

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

properties

dict[str, str]

Vereist

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

tags

dict[str, str]

Vereist

De woordenlijst met tags die u wilt toevoegen.

Uitzonderingen

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

cpu_cores

float

standaardwaarde: None

Het aantal CPU-kernen dat voor deze webservice moet worden toegewezen. Kan een decimaal getal zijn. Standaard ingesteld op 0.1

memory_gb

float

standaardwaarde: None

De hoeveelheid geheugen (in GB) die voor deze webservice moet worden toegewezen. Kan een decimaal getal zijn. De standaardwaarde is 0,5

tags

dict[str, str]

standaardwaarde: None

Een woordenlijst met sleutelwaardelabels voor deze webservice.

properties

dict[str, str]

standaardwaarde: None

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.

description

str

standaardwaarde: None

Een beschrijving voor deze webservice.

location

str

standaardwaarde: None

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

standaardwaarde: None

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

ssl_enabled

bool

standaardwaarde: None

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

enable_app_insights

bool

standaardwaarde: None

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

ssl_cert_pem_file

str

standaardwaarde: None

Het certificaatbestand dat nodig is als SSL is ingeschakeld.

ssl_key_pem_file

str

standaardwaarde: None

Het sleutelbestand dat nodig is als SSL is ingeschakeld.

ssl_cname

str

standaardwaarde: None

De cname voor als SSL is ingeschakeld.

dns_name_label

str

standaardwaarde: None

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

standaardwaarde: None

Een primaire verificatiesleutel die moet worden gebruikt voor deze webservice.

secondary_key

str

standaardwaarde: None

Een secundaire verificatiesleutel die moet worden gebruikt voor deze webservice.

collect_model_data

bool

standaardwaarde: None

Hiermee wordt aangegeven of modelgegevensverzameling voor de webservice moet worden ingeschakeld.

cmk_vault_base_url

str

standaardwaarde: None

basis-URL van door de klant beheerde sleutelkluis

cmk_key_name

str

standaardwaarde: None

door de klant beheerde sleutelnaam.

cmk_key_version

str

standaardwaarde: None

door de klant beheerde sleutelversie.

vnet_name

str

standaardwaarde: None

naam van virtueel netwerk.

subnet_name

str

standaardwaarde: None

subnetnaam in virtueel netwerk.

Retouren

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

Retourtype

AciServiceDeploymentConfiguration

Uitzonderingen

WebserviceException

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

str, datetime

Uitzonderingen

azureml.exceptions.NotImplementedError

remove_tags

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

remove_tags(tags)

Parameters

tags

list[str]

Vereist

De lijst met sleutels die moeten worden verwijderd.

run

Roep deze webservice aan met de opgegeven invoer.

run(input_data)

Parameters

input_data

<xref:varies>

Vereist

De invoer waarmee de webservice moet worden aangeroepen.

Retouren

Het resultaat van het aanroepen van de webservice.

Retourtype

dict

Uitzonderingen

WebserviceException

serialize

Converteer deze webservice naar een geserialiseerde JSON-woordenlijst.

serialize()

Retouren

De JSON-weergave van dit webserviceobject.

Retourtype

dict

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

standaardwaarde: None

Een nieuwe installatiekopieën voor implementatie in de webservice.

tags

dict[str, str]

standaardwaarde: None

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

properties

dict[str, str]

standaardwaarde: None

Een woordenlijst met sleutelwaarde-eigenschappen om toe te voegen aan bestaande eigenschappenwoordenlijst.

description

str

standaardwaarde: None

Een beschrijving voor deze webservice.

auth_enabled

bool

standaardwaarde: None

Verificatie voor deze webservice in- of uitschakelen.

ssl_enabled

bool

standaardwaarde: None

Of SSL al dan niet moet worden ingeschakeld voor deze webservice.

ssl_cert_pem_file

str

standaardwaarde: None

Het certificaatbestand dat nodig is als SSL is ingeschakeld.

ssl_key_pem_file

str

standaardwaarde: None

Het sleutelbestand dat nodig is als SSL is ingeschakeld.

ssl_cname

str

standaardwaarde: None

De cname voor als SSL is ingeschakeld.

enable_app_insights

bool

standaardwaarde: None

Of AppInsights al dan niet moet worden ingeschakeld voor deze webservice.

models

list[Model]

standaardwaarde: None

Een lijst met modelobjecten die in de bijgewerkte service moeten worden verpakt.

inference_config

InferenceConfig

standaardwaarde: None

Een InferenceConfig-object dat wordt gebruikt om de vereiste modelimplementatie-eigenschappen te bieden.

Retourtype

None