AciWebservice Třída

Představuje model strojového učení nasazený jako koncový bod webové služby ve službě Azure Container Instances.

Nasazená služba se vytvoří z modelu, skriptu a přidružených souborů. Výsledná webová služba je koncový bod HTTP s vyrovnáváním zatížení s rozhraním REST API. Do tohoto rozhraní API můžete odesílat data a přijímat predikce vrácené modelem.

Další informace najdete v tématu Nasazení modelu do služby Azure Container Instances.

Inicializuje instanci webové služby.

Konstruktor webservice načte cloudovou reprezentaci objektu webové služby přidruženého k poskytnutému pracovnímu prostoru. Vrátí instanci podřízené třídy odpovídající určitému typu načteného objektu webservice.

Konstruktor

AciWebservice(workspace, name)

Parametry

Name	Description
workspace Vyžadováno	Workspace Objekt pracovního prostoru obsahující objekt webové služby, který se má načíst.
name Vyžadováno	str Název objektu webové služby, který se má načíst.

Poznámky

Doporučeným vzorem nasazení je vytvoření objektu konfigurace nasazení s deploy_configuration metodou a jeho následné použití s deploy metodou Model třídy, jak je znázorněno níže.


   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)

Model můžete nasadit jako webovou službu několika způsoby, včetně následujících:

deploy metodu Model pro modely, které jsou již zaregistrovány v pracovním prostoru.
deploy_from_image metodou Webservice.
deploy_from_model Webservice metoda pro modely, které jsou již registrovány v pracovním prostoru. Tato metoda vytvoří image.
deploy Webservice, který zaregistruje model a vytvoří image.

Informace o práci s webovými službami najdete v tématu

Oddíl Variables uvádí atributy místní reprezentace cloudového objektu AciWebservice. Tyto proměnné by se měly považovat za jen pro čtení. Změna jejich hodnot se neprojeví v odpovídajícím cloudovém objektu.

Proměnné

Name	Description
enable_app_insights	bool Bez ohledu na to, jestli je pro webovou službu povolené protokolování Služby AppInsights.
cname	str Název cname pro webovou službu.
container_resource_requirements	ContainerResourceRequirements Požadavky na prostředky kontejneru pro webovou službu.
encryption_properties	EncryptionProperties Vlastnosti šifrování pro webovou službu.
vnet_configuration	VnetConfiguration Vlastnosti virtuální sítě pro webovou službu, konfigurace by měla být vytvořena a poskytována uživatelem.
azureml.core.webservice.AciWebservice.location	str Umístění webové služby se nasadí do.
public_ip	str Veřejná IP adresa webové služby.
azureml.core.webservice.AciWebservice.scoring_uri	str Bodovací koncový bod pro webovou službu
ssl_enabled	bool Jestli je pro webovou službu povolený protokol SSL nebo ne
public_fqdn	str Veřejný plně kvalifikovaný název domény pro webovou službu
environment	Environment Objekt Prostředí, který byl použit k vytvoření webové služby
azureml.core.webservice.AciWebservice.models	list[Model] Seznam modelů nasazených do webové služby
azureml.core.webservice.AciWebservice.swagger_uri	str Koncový bod swaggeru pro webovou službu

Metody

add_properties	Přidejte páry klíč-hodnota do slovníku vlastností této webové služby.
add_tags	Přidejte páry klíč-hodnota do slovníku značek této webové služby.
deploy_configuration	Vytvořte objekt konfigurace pro nasazení služby AciWebservice.
get_token	Načtěte ověřovací token pro tuto webovou službu s vymezeným aktuálním uživatelem. Poznámka: Není implementováno.
remove_tags	Odeberte zadané klíče ze slovníku značek této webové služby.
run	Zavolejte tuto webovou službu se zadaným vstupem.
serialize	Převeďte tuto webovou službu na serializovaný slovník JSON.
update	Aktualizujte webovou službu se zadanými vlastnostmi. Hodnoty ponechané jako Žádné zůstanou v této webové službě beze změny.

add_properties

Přidejte páry klíč-hodnota do slovníku vlastností této webové služby.

add_properties(properties)

Parametry

Name	Description
properties Vyžadováno	dict[str, str] Slovník vlastností, které chcete přidat.

add_tags

Přidejte páry klíč-hodnota do slovníku značek této webové služby.

add_tags(tags)

Parametry

Name	Description
tags Vyžadováno	dict[str, str] Slovník značek, které chcete přidat.

Výjimky

Typ	Description
WebserviceException

deploy_configuration

Vytvořte objekt konfigurace pro nasazení služby 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)

Parametry

Name	Description
cpu_cores	float Počet jader procesoru, která se mají přidělit pro tuto webovou službu. Může to být desetinné číslo. Výchozí hodnota je 0.1. Default value: None
memory_gb	float Velikost paměti (v GB) pro přidělení této webové služby. Může to být desetinné číslo. Výchozí hodnota je 0,5. Default value: None
tags	dict[str, str] Slovník značek klíč-hodnota, které této webové službě poskytnou. Default value: None
properties	dict[str, str] Slovník vlastností klíč-hodnota pro poskytnutí této webové služby. Tyto vlastnosti nelze po nasazení změnit, ale je možné přidat nové páry klíč-hodnota. Default value: None
description	str Popis této webové služby. Default value: None
location	str Oblast Azure pro nasazení této webové služby do. Pokud nezadáte umístění pracovního prostoru, použije se. Další podrobnosti o dostupných oblastech najdete v tématu Produkty podle oblastí. Default value: None
auth_enabled	bool Jestli chcete povolit ověřování pro tuto webovou službu, nebo ne. Výchozí nastavení je 'False'. Default value: None
ssl_enabled	bool Zda povolit SSL pro tuto webovou službu, nebo ne. Výchozí nastavení je 'False'. Default value: None
enable_app_insights	bool Jestli chcete povolit AppInsights pro tuto webovou službu, nebo ne. Výchozí nastavení je 'False'. Default value: None
ssl_cert_pem_file	str Pokud je povolený protokol SSL, je potřeba soubor certifikátu. Default value: None
ssl_key_pem_file	str Soubor klíče potřebný v případě, že je povolený protokol SSL. Default value: None
ssl_cname	str Název cname pro, pokud je povolený protokol SSL. Default value: None
dns_name_label	str Popisek názvu DNS pro bodovací koncový bod. Pokud nezadáte jedinečný popisek názvu DNS, vygeneruje se pro bodovací koncový bod. Default value: None
primary_key	str Primární ověřovací klíč, který se má použít pro tuto webovou službu. Default value: None
secondary_key	str Sekundární ověřovací klíč, který se má použít pro tuto webovou službu. Default value: None
collect_model_data	bool Určuje, jestli chcete povolit shromažďování dat modelu pro webovou službu. Default value: None
cmk_vault_base_url	str základní adresa URL trezoru klíčů spravovaná zákazníkem Default value: None
cmk_key_name	str název klíče spravovaného zákazníkem. Default value: None
cmk_key_version	str verze klíče spravovaného zákazníkem. Default value: None
vnet_name	str název virtuální sítě. Default value: None
subnet_name	str název podsítě v rámci virtuální sítě. Default value: None

Návraty

Typ	Description
AciServiceDeploymentConfiguration	Objekt konfigurace, který se má použít při nasazování objektu webové služby.

Výjimky

Typ	Description
WebserviceException

get_token

Načtěte ověřovací token pro tuto webovou službu s vymezeným aktuálním uživatelem.

Poznámka:

Není implementováno.

get_token()

Návraty

Typ	Description
str, datetime	Ověřovací token pro tuto webovou službu a kdy by se měl aktualizovat.

Výjimky

Typ	Description
azureml.exceptions.NotImplementedError

remove_tags

Odeberte zadané klíče ze slovníku značek této webové služby.

remove_tags(tags)

Parametry

Name	Description
tags Vyžadováno	list[str] Seznam klíčů, které chcete odebrat.

run

Zavolejte tuto webovou službu se zadaným vstupem.

run(input_data)

Parametry

Name	Description
input_data Vyžadováno	<xref:varies> Vstup pro volání webové služby.

Návraty

Typ	Description
dict	Výsledek volání webové služby.

Výjimky

Typ	Description
WebserviceException

serialize

Převeďte tuto webovou službu na serializovaný slovník JSON.

serialize()

Návraty

Typ	Description
dict	Reprezentace JSON tohoto objektu webové služby.

update

Aktualizujte webovou službu se zadanými vlastnostmi.

Hodnoty ponechané jako Žádné zůstanou v této webové službě beze změny.

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)

Parametry

Name	Description
image	Image Nová image, která se má nasadit do webové služby. Default value: None
tags	dict[str, str] Slovník značek klíč-hodnota, které této webové službě poskytnou. Nahradí existující značky. Default value: None
properties	dict[str, str] Slovník vlastností klíč-hodnota, které chcete přidat do existujícího slovníku vlastností. Default value: None
description	str Popis této webové služby. Default value: None
auth_enabled	bool Povolte nebo zakažte ověřování pro tuto webovou službu. Default value: None
ssl_enabled	bool Zda povolit SSL pro tuto webovou službu, nebo ne. Default value: None
ssl_cert_pem_file	str Pokud je povolený protokol SSL, je potřeba soubor certifikátu. Default value: None
ssl_key_pem_file	str Soubor klíče potřebný v případě, že je povolený protokol SSL. Default value: None
ssl_cname	str Název cname pro, pokud je povolený protokol SSL. Default value: None
enable_app_insights	bool Jestli chcete povolit AppInsights pro tuto webovou službu, nebo ne. Default value: None
models	list[Model] Seznam objektů modelu, které se mají zabalit do aktualizované služby. Default value: None
inference_config	InferenceConfig Objekt InferenceConfig použitý k poskytnutí požadovaných vlastností nasazení modelu. Default value: None

Návraty

Typ	Description
None

Váš názor

Byla tato stránka užitečná?

Sdílet prostřednictvím

AciWebservice Třída

Konstruktor

Parametry

Poznámky

Proměnné

Metody

add_properties

Parametry

add_tags

Parametry

Výjimky

deploy_configuration

Parametry

Návraty

Výjimky

get_token

Návraty

Výjimky

remove_tags

Parametry

run

Parametry

Návraty

Výjimky

serialize

Návraty

update

Parametry

Návraty

Váš názor