AciWebservice Osztály

Referencia

Webszolgáltatás-végpontként üzembe helyezett gépi tanulási modellt jelöl Azure Container Instances.

Az üzembe helyezett szolgáltatás modellből, szkriptből és társított fájlokból jön létre. Az eredményként kapott webszolgáltatás egy elosztott terhelésű HTTP-végpont rest API-val. Adatokat küldhet ennek az API-nak, és megkaphatja a modell által visszaadott előrejelzést.

További információ: Modell üzembe helyezése Azure Container Instances.

Inicializálja a Webservice-példányt.

A Webszolgáltatás-konstruktor lekéri a megadott munkaterülethez társított webszolgáltatás-objektum felhőbeli ábrázolását. Egy gyermekosztály egy példányát adja vissza, amely megfelel a lekért webszolgáltatás-objektum adott típusának.

Öröklődés: Webservice

AciWebservice

Konstruktor

AciWebservice(workspace, name)

Paraméterek

Name	Description
workspace Kötelező	Workspace A lekérni kívánt Webservice objektumot tartalmazó munkaterület-objektum.
name Kötelező	str A lekérni kívánt Webservice objektum neve.

Megjegyzések

Az ajánlott üzembehelyezési minta egy üzembehelyezési konfigurációs objektum létrehozása a deploy_configuration metódussal, majd az osztály metódusával deploy való használata az Model alább látható módon.


   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)

A modellek webszolgáltatásként többféleképpen is üzembe helyezhetők, többek között az alábbiakkal:

deploy metódusát a Model munkaterületen már regisztrált modellek esetében.
deploy_from_image metódusa Webservice.
deploy_from_model metódust Webservice a munkaterületen már regisztrált modellek esetében. Ez a metódus létrehoz egy lemezképet.
deploy metódusa Webservice, amely regisztrál egy modellt, és létrehoz egy rendszerképet.

A webszolgáltatások használatával kapcsolatos információkért lásd:

A Változók szakasz a felhőbeli AciWebservice objektum helyi reprezentációjának attribútumait sorolja fel. Ezeket a változókat írásvédettnek kell tekinteni. Az értékek módosítása nem jelenik meg a megfelelő felhőobjektumban.

Változók

Name	Description
enable_app_insights	bool Azt jelzi, hogy az AppInsights naplózása engedélyezve van-e a webszolgáltatáshoz.
cname	str A webszolgáltatás cname neve.
container_resource_requirements	ContainerResourceRequirements A webszolgáltatás tárolóerőforrás-követelményei.
encryption_properties	EncryptionProperties A webszolgáltatás titkosítási tulajdonságai.
vnet_configuration	VnetConfiguration A webszolgáltatás virtuális hálózati tulajdonságait, konfigurációját a felhasználónak kell létrehoznia és megadnia.
azureml.core.webservice.AciWebservice.location	str Az a hely, ahol a webszolgáltatás üzembe van helyezve.
public_ip	str A webszolgáltatás nyilvános IP-címe.
azureml.core.webservice.AciWebservice.scoring_uri	str A webszolgáltatás pontozási végpontja
ssl_enabled	bool Azt jelzi, hogy az SSL engedélyezve van-e a webszolgáltatásban
public_fqdn	str A webszolgáltatás nyilvános teljes tartományneve
environment	Environment A webszolgáltatás létrehozásához használt Környezeti objektum
azureml.core.webservice.AciWebservice.models	list[Model] A webszolgáltatásban üzembe helyezett modellek listája
azureml.core.webservice.AciWebservice.swagger_uri	str A webszolgáltatás Swagger-végpontja

Metódusok

add_properties	Adjon hozzá kulcsértékpárokat a webszolgáltatás tulajdonságszótárához.
add_tags	Adjon hozzá kulcsértékpárokat a webszolgáltatás címkeszótárához.
deploy_configuration	Hozzon létre egy konfigurációs objektumot az AciWebservice üzembe helyezéséhez.
get_token	Kérje le a webszolgáltatás hitelesítési jogkivonatát, amely az aktuális felhasználóra terjed ki. Megjegyzés Nincs implementálva.
remove_tags	Távolítsa el a megadott kulcsokat a webszolgáltatás címkékből álló szótárából.
run	Hívja meg ezt a webszolgáltatást a megadott bemenettel.
serialize	Konvertálja ezt a webszolgáltatást JSON szerializált szótárlá.
update	Frissítse a webszolgáltatást a megadott tulajdonságokkal. A Nincs érték változatlan marad ebben a webszolgáltatásban.

add_properties

Adjon hozzá kulcsértékpárokat a webszolgáltatás tulajdonságszótárához.

add_properties(properties)

Paraméterek

Name	Description
properties Kötelező	dict[str, str] A hozzáadni kívánt tulajdonságok szótára.

add_tags

Adjon hozzá kulcsértékpárokat a webszolgáltatás címkeszótárához.

add_tags(tags)

Paraméterek

Name	Description
tags Kötelező	dict[str, str] A hozzáadni kívánt címkék szótára.

Kivételek

Típus	Description
WebserviceException

deploy_configuration

Hozzon létre egy konfigurációs objektumot az AciWebservice üzembe helyezéséhez.

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)

Paraméterek

Name	Description
cpu_cores	float A webszolgáltatáshoz lefoglalandó processzormagok száma. Tizedes tört is lehet. Alapértelmezett érték: 0,1 Alapértelmezett érték: None
memory_gb	float A webszolgáltatás számára lefoglalandó memória mennyisége (GB-ban). Tizedes tört is lehet. Alapértelmezett érték: 0,5 Alapértelmezett érték: None
tags	dict[str, str] A webszolgáltatáshoz tartozó kulcsértékcímkék szótára. Alapértelmezett érték: None
properties	dict[str, str] A webszolgáltatáshoz tartozó kulcsérték-tulajdonságok szótára. Ezek a tulajdonságok az üzembe helyezés után nem módosíthatók, de új kulcsértékpárok is hozzáadhatók. Alapértelmezett érték: None
description	str A webszolgáltatás leírásának megadása. Alapértelmezett érték: None
location	str A webszolgáltatás üzembe helyezéséhez szükséges Azure-régió. Ha nincs megadva, a munkaterület helye lesz használva. Az elérhető régiókkal kapcsolatos további információkért lásd: Termékek régiónként. Alapértelmezett érték: None
auth_enabled	bool Azt jelzi, hogy engedélyezi-e a hitelesítést ehhez a webszolgáltatáshoz. Alapértelmezés szerint Hamis. Alapértelmezett érték: None
ssl_enabled	bool Azt határozza meg, hogy engedélyezi-e az SSL-t ehhez a webszolgáltatáshoz. Alapértelmezés szerint Hamis. Alapértelmezett érték: None
enable_app_insights	bool Azt határozza meg, hogy engedélyezi-e az AppInsights szolgáltatást ehhez a webszolgáltatáshoz. Alapértelmezés szerint Hamis. Alapértelmezett érték: None
ssl_cert_pem_file	str Az SSL engedélyezéséhez szükséges tanúsítványfájl. Alapértelmezett érték: None
ssl_key_pem_file	str Az SSL engedélyezéséhez szükséges kulcsfájl. Alapértelmezett érték: None
ssl_cname	str A cname értéke, ha az SSL engedélyezve van. Alapértelmezett érték: None
dns_name_label	str A pontozási végpont DNS-névcímkéje. Ha nincs megadva egyedi DNS-névcímke a pontozási végponthoz. Alapértelmezett érték: None
primary_key	str A webszolgáltatáshoz használandó elsődleges hitelesítési kulcs. Alapértelmezett érték: None
secondary_key	str A webszolgáltatáshoz használandó másodlagos hitelesítési kulcs. Alapértelmezett érték: None
collect_model_data	bool Engedélyezve van-e a modelladatok gyűjtése a webszolgáltatásban. Alapértelmezett érték: None
cmk_vault_base_url	str ügyfél által felügyelt kulcstartó alap URL-címe Alapértelmezett érték: None
cmk_key_name	str ügyfél által felügyelt kulcs neve. Alapértelmezett érték: None
cmk_key_version	str ügyfél által felügyelt kulcs verziója. Alapértelmezett érték: None
vnet_name	str virtuális hálózat neve. Alapértelmezett érték: None
subnet_name	str alhálózat neve a virtuális hálózaton belül. Alapértelmezett érték: None

Válaszok

Típus	Description
AciServiceDeploymentConfiguration	Egy webszolgáltatási objektum üzembe helyezésekor használandó konfigurációs objektum.

Kivételek

Típus	Description
WebserviceException

get_token

Kérje le a webszolgáltatás hitelesítési jogkivonatát, amely az aktuális felhasználóra terjed ki.

Megjegyzés

Nincs implementálva.

get_token()

Válaszok

Típus	Description
str, datetime	A webszolgáltatás hitelesítési jogkivonata, és azt követően, hogy mikor kell frissíteni.

Kivételek

Típus	Description
azureml.exceptions.NotImplementedError

remove_tags

Távolítsa el a megadott kulcsokat a webszolgáltatás címkékből álló szótárából.

remove_tags(tags)

Paraméterek

Name	Description
tags Kötelező	list[str] Az eltávolítandó kulcsok listája.

run

Hívja meg ezt a webszolgáltatást a megadott bemenettel.

run(input_data)

Paraméterek

Name	Description
input_data Kötelező	<xref:varies> A webszolgáltatás meghívásához szükséges bemenet.

Válaszok

Típus	Description
dict	A webszolgáltatás meghívásának eredménye.

Kivételek

Típus	Description
WebserviceException

serialize

Konvertálja ezt a webszolgáltatást JSON szerializált szótárlá.

serialize()

Válaszok

Típus	Description
dict	A webszolgáltatási objektum JSON-ábrázolása.

update

Frissítse a webszolgáltatást a megadott tulajdonságokkal.

A Nincs érték változatlan marad ebben a webszolgáltatásban.

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)

Paraméterek

Name	Description
image	Image A webszolgáltatásban üzembe helyezendő új rendszerkép. Alapértelmezett érték: None
tags	dict[str, str] A webszolgáltatáshoz tartozó kulcsértékcímkék szótára. Lecseréli a meglévő címkéket. Alapértelmezett érték: None
properties	dict[str, str] A meglévő tulajdonságok szótárához hozzáadandó kulcsérték-tulajdonságok szótára. Alapértelmezett érték: None
description	str A webszolgáltatás leírásának megadása. Alapértelmezett érték: None
auth_enabled	bool Engedélyezze vagy tiltsa le a hitelesítést ehhez a webszolgáltatáshoz. Alapértelmezett érték: None
ssl_enabled	bool Azt határozza meg, hogy engedélyezi-e az SSL-t ehhez a webszolgáltatáshoz. Alapértelmezett érték: None
ssl_cert_pem_file	str Az SSL engedélyezéséhez szükséges tanúsítványfájl. Alapértelmezett érték: None
ssl_key_pem_file	str Az SSL engedélyezéséhez szükséges kulcsfájl. Alapértelmezett érték: None
ssl_cname	str A cname értéke, ha az SSL engedélyezve van. Alapértelmezett érték: None
enable_app_insights	bool Azt határozza meg, hogy engedélyezi-e az AppInsights szolgáltatást ehhez a webszolgáltatáshoz. Alapértelmezett érték: None
models	list[Model] A frissített szolgáltatásba csomagolandó modellobjektumok listája. Alapértelmezett érték: None
inference_config	InferenceConfig Egy InferenceConfig objektum, amely a modell szükséges üzembehelyezési tulajdonságainak megadására szolgál. Alapértelmezett érték: None

Válaszok

Típus	Description
None

Megosztás a következőn keresztül:

AciWebservice Osztály

Konstruktor

Paraméterek

Megjegyzések

Változók

Metódusok

add_properties

Paraméterek

add_tags

Paraméterek

Kivételek

deploy_configuration

Paraméterek

Válaszok

Kivételek

get_token

Válaszok

Kivételek

remove_tags

Paraméterek

run

Paraméterek

Válaszok

Kivételek

serialize

Válaszok

update

Paraméterek

Válaszok

Visszajelzés

További források