Sdílet prostřednictvím

AciWebservice Třída

  • Reference

Představuje model strojového učení nasazený jako koncový bod webové služby na 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 předpovědi vrácené modelem.

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

Inicializuje instanci webové služby.

Konstruktor webové služby 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í konkrétnímu typu načteného objektu Webové služby.

Dědičnost
Webservice
AciWebservice

Konstruktor

AciWebservice(workspace, name)

Parametry

workspace
Workspace
Vyžadováno

Objekt pracovního prostoru obsahující objekt webové služby, který se má načíst.

name
str
Vyžadováno

Název objektu webové služby, který se má načíst.

Poznámky

Doporučeným vzorem nasazení je vytvořit objekt konfigurace nasazení pomocí deploy_configuration metody a pak ho použít s metodou deployModel 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)

Existuje několik způsobů, jak nasadit model jako webovou službu, včetně:

  • deployModel metoda pro modely již zaregistrované v pracovním prostoru.

  • deploy_from_imagemetoda .Webservice

  • deploy_from_modelWebservice pro modely již zaregistrované v pracovním prostoru. Tato metoda vytvoří image.

  • deployWebservicemetoda , která zaregistruje model a vytvoří image.

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

V části Variables (Proměnné) jsou uvedeny atributy místní reprezentace objektu AciWebservice cloudu. Tyto proměnné by měly být považovány za jen pro čtení. Změna jejich hodnot se neprojeví v odpovídajícím cloudovém objektu.

Proměnné

enable_app_insights
bool

Určuje, jestli je pro webovou službu povolené protokolování AppInsights.

cname
str

Název cname webové služby.

container_resource_requirements
ContainerResourceRequirements

Požadavky na prostředky kontejneru pro webovou službu.

encryption_properties
EncryptionProperties

Vlastnosti šifrování webové služby.

vnet_configuration
VnetConfiguration

Vlastnosti virtuální sítě pro webovou službu by měl vytvořit a poskytnout uživatel.

azureml.core.webservice.AciWebservice.location
str

Umístění, do které je webová služba nasazená.

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

Určuje, jestli je pro webovou službu povolený protokol SSL.

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íčových hodnot do slovníku vlastností této webové služby.
add_tags

Přidejte páry hodnot klíčů 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 oborem pro aktuálního uživatele.

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 pomocí zadaných vlastností.

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

add_properties

Přidejte páry klíčových hodnot do slovníku vlastností této webové služby.

add_properties(properties)

Parametry

properties
dict[str, str]
Vyžadováno

Slovník vlastností, které chcete přidat.

add_tags

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

add_tags(tags)

Parametry

tags
dict[str, str]
Vyžadováno

Slovník značek, které chcete přidat.

Výjimky

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

cpu_cores
float
výchozí hodnota: None

Počet jader procesoru, která se mají přidělit pro tuto webovou službu. Může to být desetinná čárka. Výchozí hodnota je 0.1.

memory_gb
float
výchozí hodnota: None

Velikost paměti (v GB), která se má přidělit této webové službě. Může to být desetinná čárka. Výchozí hodnota je 0,5.

tags
dict[str, str]
výchozí hodnota: None

Slovník značek klíčových hodnot pro tuto webovou službu.

properties
dict[str, str]
výchozí hodnota: None

Slovník vlastností klíčové hodnoty, které mají dát této webové službě. Tyto vlastnosti nelze po nasazení změnit, je však možné přidat nové páry hodnot klíčů.

description
str
výchozí hodnota: None

Popis pro tuto webovou službu.

location
str
výchozí hodnota: None

Oblast Azure, do které chcete tuto webovou službu nasadit. Pokud není zadáno, použije se umístění pracovního prostoru. Další podrobnosti o dostupných oblastech najdete v tématu Produkty podle oblasti.

auth_enabled
bool
výchozí hodnota: None

Zda se má povolit ověřování pro tuto webovou službu. Výchozí hodnota je False.

ssl_enabled
bool
výchozí hodnota: None

Zda se má povolit ssl pro tuto webovou službu. Výchozí hodnota je False.

enable_app_insights
bool
výchozí hodnota: None

Jestli chcete povolit AppInsights pro tuto webovou službu. Výchozí hodnota je False.

ssl_cert_pem_file
str
výchozí hodnota: None

Soubor certifikátu, který je potřeba, pokud je povolený protokol SSL.

ssl_key_pem_file
str
výchozí hodnota: None

Soubor klíče, který je potřeba, pokud je povolený protokol SSL.

ssl_cname
str
výchozí hodnota: None

Název cname pro, pokud je povolený protokol SSL.

dns_name_label
str
výchozí hodnota: None

Popisek názvu DNS bodujícího koncového bodu Pokud ho nezadáte, vygeneruje se pro bodovací koncový bod jedinečný popisek názvu DNS.

primary_key
str
výchozí hodnota: None

Primární ověřovací klíč, který se má použít pro tuto webovou službu.

secondary_key
str
výchozí hodnota: None

Sekundární ověřovací klíč, který se má použít pro tuto webovou službu.

collect_model_data
bool
výchozí hodnota: None

Jestli se má povolit shromažďování dat modelu pro webovou službu.

cmk_vault_base_url
str
výchozí hodnota: None

Základní adresa URL trezoru klíčů spravovaná zákazníkem

cmk_key_name
str
výchozí hodnota: None

název klíče spravovaného zákazníkem.

cmk_key_version
str
výchozí hodnota: None

verze klíče spravovaného zákazníkem.

vnet_name
str
výchozí hodnota: None

název virtuální sítě.

subnet_name
str
výchozí hodnota: None

název podsítě v rámci virtuální sítě.

Návraty

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

Návratový typ

AciServiceDeploymentConfiguration

Výjimky

WebserviceException

get_token

Načtěte ověřovací token pro tuto webovou službu s oborem pro aktuálního uživatele.

Poznámka

Není implementováno.

get_token()

Návraty

Ověřovací token pro tuto webovou službu a informace o tom, kdy se má aktualizovat.

Návratový typ

str, datetime

Výjimky

azureml.exceptions.NotImplementedError

remove_tags

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

remove_tags(tags)

Parametry

tags
list[str]
Vyžadováno

Seznam klíčů, které se mají odebrat.

run

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

run(input_data)

Parametry

input_data
<xref:varies>
Vyžadováno

Vstup, který má webovou službu volat.

Návraty

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

Návratový typ

dict

Výjimky

WebserviceException

serialize

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

serialize()

Návraty

Reprezentace JSON tohoto objektu webové služby

Návratový typ

dict

update

Aktualizujte webovou službu pomocí zadaných vlastností.

Hodnoty ponechané jako None 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

image
Image
výchozí hodnota: None

Nová image, která se nasadí do webové služby.

tags
dict[str, str]
výchozí hodnota: None

Slovník značek klíčových hodnot pro tuto webovou službu. Nahradí existující značky.

properties
dict[str, str]
výchozí hodnota: None

Slovník vlastností klíčové hodnoty, které se mají přidat do existujícího slovníku vlastností.

description
str
výchozí hodnota: None

Popis pro tuto webovou službu.

auth_enabled
bool
výchozí hodnota: None

Povolte nebo zakažte ověřování pro tuto webovou službu.

ssl_enabled
bool
výchozí hodnota: None

Zda se má povolit ssl pro tuto webovou službu.

ssl_cert_pem_file
str
výchozí hodnota: None

Soubor certifikátu, který je potřeba, pokud je povolený protokol SSL.

ssl_key_pem_file
str
výchozí hodnota: None

Soubor klíče, který je potřeba, pokud je povolený protokol SSL.

ssl_cname
str
výchozí hodnota: None

Název cname pro, pokud je povolený protokol SSL.

enable_app_insights
bool
výchozí hodnota: None

Jestli chcete povolit AppInsights pro tuto webovou službu.

models
list[Model]
výchozí hodnota: None

Seznam objektů modelu, které se mají zabalit do aktualizované služby.

inference_config
InferenceConfig
výchozí hodnota: None

Objekt InferenceConfig, který slouží k poskytnutí požadovaných vlastností nasazení modelu.

Návratový typ

None