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.

Inicializujte 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í konkrétnímu typu načteného objektu Webservice.

Dědičnost
Webservice
AciWebservice

Konstruktor

AciWebservice(workspace, name)

Parametry

Name Description
workspace
Vyžadováno
Workspace

Objekt pracovního prostoru obsahující objekt Webservice, který se má načíst.
name
Vyžadováno
str

Název objektu Webservice, který se má načíst.

Poznámky

Doporučeným vzorem nasazení je vytvoření objektu konfigurace nasazení pomocí deploy_configuration metody 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)

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

  • deploy Model pro modely již zaregistrované v pracovním prostoru.

  • deploy_from_image metoda metody Webservice.

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

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

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

Část Variables (Proměnné ) obsahuje seznam atributů 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

Určuje, jestli je pro webovou službu povolené protokolování 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, konfiguraci 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í 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řidat páry hodnot klíčů 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ě nezměněné.

add_properties

Přidat páry hodnot klíčů 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 hodnot klíčů 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é se mají 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 být desetinná čárka. Výchozí hodnota je 0,1.

Default value: None
memory_gb
float

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

Default value: None
tags
dict[str, str]

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

Default value: None
properties
dict[str, str]

Slovník vlastností klíčové hodnoty pro tuto webovou službu. Tyto vlastnosti nelze po nasazení změnit, je však možné přidat nové páry hodnot klíčů.

Default value: None
description
str

Popis pro tuto webovou službu.

Default value: None
location
str

Oblast Azure, do které se má tato webová služba nasadit. Pokud ho nezadáte, použije se umístění pracovního prostoru. Další podrobnosti o dostupných oblastech najdete v tématu Produkty v jednotlivých oblastech.

Default value: None
auth_enabled
bool

Určuje, jestli se má povolit ověřování pro tuto webovou službu. Výchozí hodnota je False.

Default value: None
ssl_enabled
bool

Určuje, jestli se má povolit SSL pro tuto webovou službu. Výchozí hodnota je False.

Default value: None
enable_app_insights
bool

Určuje, jestli se má povolit AppInsights pro tuto webovou službu. Výchozí hodnota je False.

Default value: None
ssl_cert_pem_file
str

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

Default value: None
ssl_key_pem_file
str

Soubor klíče, který je potřeba, pokud 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 bodujícího koncového bodu. Pokud není zadaný, pro bodovací koncový bod se vygeneruje jedinečný popisek názvu DNS.

Default value: None
primary_key
str

Primární ověřovací klíč, který se použije 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 se má 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ého 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 oborem pro aktuálního uživatele.

Poznámka

Není implementováno.

get_token()

Návraty

Typ Description
str, datetime

Ověřovací token pro tuto webovou službu a informace o tom, kdy by se měla 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é se mají 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 Webservice.

update

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

Hodnoty ponechané jako None zůstanou v této webové službě nezměněné.

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 nasadí do webové služby.

Default value: None
tags
dict[str, str]

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

Default value: None
properties
dict[str, str]

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

Default value: None
description
str

Popis pro tuto webovou službu.

Default value: None
auth_enabled
bool

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

Default value: None
ssl_enabled
bool

Určuje, jestli se má povolit SSL pro tuto webovou službu.

Default value: None
ssl_cert_pem_file
str

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

Default value: None
ssl_key_pem_file
str

Soubor klíče, který je potřeba, pokud 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

Určuje, jestli se má povolit AppInsights pro tuto webovou službu.

Default value: None
models
list[Model]

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

Default value: None
inference_config
InferenceConfig

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

Default value: None

Návraty

Typ Description
None