AciWebservice Třída
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
-
AciWebservice
Konstruktor
AciWebservice(workspace, name)
Parametry
- workspace
- Workspace
Objekt pracovního prostoru obsahující objekt 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
Využívání modelu služby Azure Machine Learning nasazeného jako webová služba
Monitorování a shromažďování dat z koncových bodů webové služby ML
Čá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é
- 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.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
add_tags
Přidejte páry hodnot klíčů do slovníku značek této webové služby.
add_tags(tags)
Parametry
Výjimky
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
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.
- 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.
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íčů.
- 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.
- auth_enabled
- bool
Určuje, jestli se má povolit ověřování pro tuto webovou službu. Výchozí hodnota je False.
- ssl_enabled
- bool
Určuje, jestli se má povolit SSL pro tuto webovou službu. Výchozí hodnota je False.
- enable_app_insights
- bool
Určuje, jestli se má povolit AppInsights pro tuto webovou službu. Výchozí hodnota je False.
- ssl_cert_pem_file
- str
Soubor certifikátu, který je potřeba, pokud je povolený protokol SSL.
- ssl_key_pem_file
- str
Soubor klíče, který je potřeba, pokud je povolený protokol SSL.
- 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.
- primary_key
- str
Primární ověřovací klíč, který se použije pro tuto webovou službu.
- secondary_key
- str
Sekundární ověřovací klíč, který se má použít pro tuto webovou službu.
- collect_model_data
- bool
Určuje, jestli se má povolit shromažďování dat modelu pro webovou službu.
- cmk_vault_base_url
- str
Základní adresa URL trezoru klíčů spravovaného zákazníkem
Návraty
Objekt konfigurace, který se má použít při nasazování objektu Webové služby.
Návratový typ
Výjimky
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 by se měla aktualizovat.
Návratový typ
Výjimky
remove_tags
Odeberte zadané klíče ze slovníku značek této webové služby.
remove_tags(tags)
Parametry
run
Zavolejte tuto webovou službu se zadaným vstupem.
run(input_data)
Parametry
- input_data
- <xref:varies>
Vstup pro volání webové služby.
Návraty
Výsledek volání webové služby.
Návratový typ
Výjimky
serialize
Převeďte tuto webovou službu na serializovaný slovník JSON.
serialize()
Návraty
Reprezentace JSON tohoto objektu Webservice.
Návratový typ
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
Slovník značek klíčových hodnot pro tuto webovou službu. Nahradí existující značky.
Slovník vlastností hodnoty klíče, které se mají přidat do existujícího slovníku vlastností.
- ssl_cert_pem_file
- str
Soubor certifikátu, který je potřeba, pokud je povolený protokol SSL.
- ssl_key_pem_file
- str
Soubor klíče, který je potřeba, pokud je povolený protokol SSL.
- enable_app_insights
- bool
Určuje, jestli se má povolit AppInsights pro tuto webovou službu.
Seznam objektů modelu, které se mají zabalit do aktualizované služby.
- inference_config
- InferenceConfig
InferenceConfig Objekt slouží k poskytnutí požadovaných vlastností nasazení modelu.
Návratový typ
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro