LocalWebservice Osztály

Helyi webszolgáltatás-végpontként üzembe helyezett gépi tanulási modellt jelöl.

A webszolgáltatások helyi üzembe helyezése hasznos hibakeresési és tesztelési forgatókönyvek esetén.

Helyi webszolgáltatás-konstruktor.

A LocalWebservice konstruktor a megadott munkaterülethez társított LocalWebservice objektum helyi reprezentációjának lekérésére szolgál.

Öröklődés

Webservice

LocalWebservice

Konstruktor

LocalWebservice(*args, **kwargs)

Paraméterek

Name	Description
workspace Kötelező	Workspace A lekérendő modellobjektumokat tartalmazó munkaterület-objektum.
name Kötelező	str A lekérendő webszolgáltatás-objektum neve.
must_exist Kötelező	bool Azt jelzi, hogy a webszolgáltatásnak már léteznie kell-e a memóriában lévő objektum létrehozásakor.
workspace Kötelező	Workspace A lekérendő modellobjektumokat tartalmazó munkaterület-objektum.
name Kötelező	str A lekérendő LocalWebservice objektum neve.
must_exist Kötelező	bool Azt jelzi, hogy a webszolgáltatásnak már léteznie kell-e a memóriában lévő objektum létrehozásakor.

Megjegyzések

Az alábbi kódminták bemutatják, hogyan hozhat létre helyi Docker-webszolgáltatást. További részletekért tekintse meg a jegyzetfüzet hivatkozását.

   from azureml.core.webservice import LocalWebservice

   # This is optional, if not provided Docker will choose a random unused port.
   deployment_config = LocalWebservice.deploy_configuration(port=6789)

   local_service = Model.deploy(ws, "test", [model], inference_config, deployment_config)

   local_service.wait_for_deployment()

A teljes minta a következő forrásból érhető el: https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/deployment/deploy-to-local/register-model-deploy-local.ipynb

Metódusok

delete	Törölje ezt a LocalWebservice szolgáltatást a helyi gépről. Ez a függvényhívás nem aszinkron; a szolgáltatás törléséig fut.
deploy_configuration	Hozzon létre egy konfigurációs objektumot egy helyi webszolgáltatás üzembe helyezéséhez.
deploy_to_cloud	Webszolgáltatás üzembe helyezése a LocalWebservice konfigurációja alapján.
deserialize	Modellkezelési szolgáltatás válasz JSON-objektumának átalakítása webszolgáltatás-objektummá. Megjegyzés A LocalWebservice nem támogatott.
get_keys	Kérje le a webszolgáltatás hitelesítési kulcsait. Megjegyzés A LocalWebservice nem támogatott.
get_logs	A LocalWebservice naplóinak lekérése.
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 A LocalWebservice nem támogatott.
list	Listázhatja a megfelelő munkaterülethez társított LocalWebservices szolgáltatásokat. A visszaadott eredmények paraméterekkel szűrhetők.
regen_key	Hozza létre újra a webszolgáltatás egyik kulcsát. Megjegyzés A LocalWebservice nem támogatott.
reload	Töltse be újra a LocalWebservice végrehajtási szkriptjét és függőségeit. Ezzel újraindítja a szolgáltatás tárolóját a frissített objektumok másolataival, beleértve a végrehajtási szkriptet és a helyi függőségeket, de nem építi újra az alapul szolgáló rendszerképet. Ennek megfelelően a Conda/pip-függőségek vagy az egyéni Docker-lépések módosításai nem jelennek meg az újra betöltött LocalWebservice szolgáltatásban. A módosítások kezeléséhez hívja inkább a metódust update .
run	Hívja meg ezt a LocalWebservice szolgáltatást a megadott bemenettel.
serialize	Konvertálja ezt a webszolgáltatás-objektumot JSON-szerializált szótárlá.
update	Frissítse a LocalWebservice szolgáltatást a megadott tulajdonságokkal. A Nincs érték változatlan marad ebben a LocalWebservice szolgáltatásban.
update_deployment_state	Frissítse a memóriában lévő objektum aktuális állapotát. Végezze el az objektum tulajdonságainak helyben történő frissítését a megfelelő helyi Docker-tároló aktuális állapota alapján.
wait_for_deployment	Lekérdezi a LocalWebservice futó üzembe helyezését.

delete

Törölje ezt a LocalWebservice szolgáltatást a helyi gépről.

Ez a függvényhívás nem aszinkron; a szolgáltatás törléséig fut.

delete(delete_cache=True, delete_image=False, delete_volume=True)

Paraméterek

Name	Description
delete_cache Kötelező	bool A szolgáltatáshoz gyorsítótárazott ideiglenes fájlok törlése. (Alapértelmezett: Igaz)
delete_image Kötelező	bool A szolgáltatás Docker-lemezképének törlése. (Alapértelmezett: Hamis)
delete_volume Kötelező	bool A szolgáltatás Docker-kötetének törlése. (Alapértelmezett: Igaz)

Kivételek

Típus	Description
WebserviceException

deploy_configuration

Hozzon létre egy konfigurációs objektumot egy helyi webszolgáltatás üzembe helyezéséhez.

static deploy_configuration(port=None)

Paraméterek

Name	Description
port	int A helyi port, amelyen elérhetővé szeretné tenni a szolgáltatás HTTP-végpontját. Alapértelmezett érték: None

Válaszok

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

Kivételek

Típus	Description
WebserviceException

deploy_to_cloud

Webszolgáltatás üzembe helyezése a LocalWebservice konfigurációja alapján.

deploy_to_cloud(name=None, deployment_config=None, deployment_target=None)

Paraméterek

Name	Description
name	str Az üzembe helyezett szolgáltatás nevét adja meg. A munkaterületnek egyedinek kell lennie. Alapértelmezett érték: None
deployment_config	WebserviceDeploymentConfiguration A webszolgáltatás konfigurálásához használt WebserviceDeploymentConfiguration. Ha nincs megadva, a rendszer egy üres konfigurációs objektumot használ a kívánt cél alapján. Alapértelmezett érték: None
deployment_target	ComputeTarget A ComputeTarget , amelyre telepíteni szeretné a webszolgáltatást. Mivel az ACI-nek nincs társított értéke ComputeTarget, hagyja ezt a paramétert Nincs értéken az ACI-ben való üzembe helyezéshez. Alapértelmezett érték: None

Válaszok

Típus	Description
Webservice	Az üzembe helyezett webszolgáltatásnak megfelelő webszolgáltatás-objektum.

Kivételek

Típus	Description
WebserviceException

deserialize

Modellkezelési szolgáltatás válasz JSON-objektumának átalakítása webszolgáltatás-objektummá.

Megjegyzés

A LocalWebservice nem támogatott.

deserialize(workspace, webservice_payload)

Paraméterek

Name	Description
cls Kötelező
workspace Kötelező	Workspace A webszolgáltatás által regisztrált munkaterület-objektum.
webservice_payload Kötelező	dict Egy JSON-objektum, amely webszolgáltatás-objektummá konvertálható.

Kivételek

Típus	Description
azureml.exceptions.NotImplementedError

get_keys

Kérje le a webszolgáltatás hitelesítési kulcsait.

Megjegyzés

A LocalWebservice nem támogatott.

get_keys()

Válaszok

Típus	Description
	A webszolgáltatás hitelesítési kulcsai.

Kivételek

Típus	Description
azureml.exceptions.NotImplementedError

get_logs

A LocalWebservice naplóinak lekérése.

get_logs(num_lines=5000, raw=False)

Paraméterek

Name	Description
num_lines Kötelező	int A beolvasandó naplósorok maximális száma. (Alapértelmezett: 5000)
raw Kötelező	bool A nyers Docker-tároló kimenetét adja vissza anélkül, hogy megkísérli formázni. (Alapértelmezett: Hamis)

Válaszok

Típus	Description
str	A LocalWebservice naplói.

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

A LocalWebservice nem támogatott.

get_token()

Válaszok

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

Kivételek

Típus	Description
azureml.exceptions.NotImplementedError

list

Listázhatja a megfelelő munkaterülethez társított LocalWebservices szolgáltatásokat.

A visszaadott eredmények paraméterekkel szűrhetők.

static list(workspace, model_name=None, model_id=None, all=None)

Paraméterek

Name	Description
workspace Kötelező	Workspace A LocalWebservices szolgáltatáshoz társított munkaterület-objektum.
model_name	str A szűrőlista csak az adott modellnévvel üzembe helyezett LocalWebservice-eket tartalmazza. Alapértelmezett érték: None
model_id	str A szűrőlista csak az adott modellazonosítóval üzembe helyezett LocalWebservice-eket tartalmazza. Alapértelmezett érték: None
all	bool Az összes szolgáltatás megjelenítése. Alapértelmezés szerint csak a futó szolgáltatások jelennek meg. Alapértelmezett érték: None

Válaszok

Típus	Description
list[LocalWebservice]	A megadott munkaterülethez társított LocalWebservices szűrt listája.

Kivételek

Típus	Description
WebserviceException

regen_key

Hozza létre újra a webszolgáltatás egyik kulcsát.

Megjegyzés

A LocalWebservice nem támogatott.

regen_key(key)

Paraméterek

Name	Description
key Kötelező	str Melyik kulcsot kell újragenerálni. A beállítások az "Elsődleges" vagy a "Másodlagos"

Kivételek

Típus	Description
NotImplementedError

reload

Töltse be újra a LocalWebservice végrehajtási szkriptjét és függőségeit.

Ezzel újraindítja a szolgáltatás tárolóját a frissített objektumok másolataival, beleértve a végrehajtási szkriptet és a helyi függőségeket, de nem építi újra az alapul szolgáló rendszerképet. Ennek megfelelően a Conda/pip-függőségek vagy az egyéni Docker-lépések módosításai nem jelennek meg az újra betöltött LocalWebservice szolgáltatásban. A módosítások kezeléséhez hívja inkább a metódust update .

reload(wait=False)

Paraméterek

Name	Description
wait Kötelező	bool Várjon, amíg a szolgáltatás tárolója kifogástalan állapotba ér. (Alapértelmezett: Hamis)

Kivételek

Típus	Description
WebserviceException

run

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

run(input_data)

Paraméterek

Name	Description
input_data Kötelező	<xref:varies> Az a bemenet, amellyel meghívhatja a LocalWebservice szolgáltatást.

Válaszok

Típus	Description
<xref:varies>	A LocalWebservice meghívásának eredménye.

Kivételek

Típus	Description
WebserviceException

serialize

Konvertálja ezt a webszolgáltatás-objektumot JSON-szerializált szótárlá.

serialize()

Válaszok

Típus	Description
dict	A Webservice objektum szerializált ábrázolása.

Kivételek

Típus	Description
WebserviceException

update

Frissítse a LocalWebservice szolgáltatást a megadott tulajdonságokkal.

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

update(models=None, image_config=None, deployment_config=None, wait=False, inference_config=None)

Paraméterek

Name	Description
models Kötelező	list[Model] A LocalWebservice új modelllistája.
image_config Kötelező	ContainerImageConfig A LocalWebservice szolgáltatásra alkalmazandó képkonfigurációs beállítások.
deployment_config Kötelező	LocalWebserviceDeploymentConfiguration A LocalWebservice szolgáltatásra alkalmazandó üzembehelyezési konfigurációs beállítások.
inference_config Kötelező	InferenceConfig Egy InferenceConfig objektum, amely a modell szükséges üzembehelyezési tulajdonságainak megadására szolgál.
wait Kötelező	bool Várjon, amíg a szolgáltatás tárolója kifogástalan állapotba ér. (Alapértelmezett: Hamis)

Válaszok

Típus	Description
None

Kivételek

Típus	Description
WebserviceException

update_deployment_state

Frissítse a memóriában lévő objektum aktuális állapotát.

Végezze el az objektum tulajdonságainak helyben történő frissítését a megfelelő helyi Docker-tároló aktuális állapota alapján.

update_deployment_state(must_exist=False)

Paraméterek

Name	Description
must_exist	bool Azt jelzi, hogy a webszolgáltatásnak már léteznie kell-e a memóriában lévő objektum létrehozásakor. Alapértelmezett érték: False

Kivételek

Típus	Description
WebserviceException

wait_for_deployment

Lekérdezi a LocalWebservice futó üzembe helyezését.

wait_for_deployment(show_output=False)

Paraméterek

Name	Description
show_output Kötelező	bool A részletes kimenet nyomtatásának lehetősége. (Alapértelmezett: Hamis)

Kivételek

Típus	Description
WebserviceException

Attribútumok

port

Szerezze be a helyi webszolgáltatási portot.

Válaszok

Típus	Description
int	Portszám.

scoring_uri

Szerezze be a helyi webszolgáltatás pontozási URI-ját.

Válaszok

Típus	Description
str	Pontozási URI.

swagger_uri

Szerezze be a Swagger helyi webszolgáltatás URI-ját.

Válaszok

Típus	Description
str	Swagger URI.

NETWORK_NAME

NETWORK_NAME = 'azureml-local'

STATE_DELETED

STATE_DELETED = 'deleted'

STATE_DEPLOYING

STATE_DEPLOYING = 'deploying'

STATE_FAILED

STATE_FAILED = 'failed'

STATE_RUNNING

STATE_RUNNING = 'running'

STATE_UNKNOWN

STATE_UNKNOWN = 'unknown'