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
LocalWebservice

Konstruktor

LocalWebservice(*args, **kwargs)

Paraméterek

workspace
Workspace
Kötelező

A lekérendő modellobjektumokat tartalmazó munkaterület-objektum.

name
str
Kötelező

A lekérendő webszolgáltatás-objektum neve.

must_exist
bool
Kötelező

Azt jelzi, hogy a webszolgáltatásnak már léteznie kell-e a memóriában lévő objektum létrehozásakor.

workspace
Workspace
Kötelező

A lekérendő modellobjektumokat tartalmazó munkaterület-objektum.

name
str
Kötelező

A lekérendő LocalWebservice objektum neve.

must_exist
bool
Kötelező

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

delete_cache
bool
Kötelező

A szolgáltatáshoz gyorsítótárazott ideiglenes fájlok törlése. (Alapértelmezett: Igaz)

delete_image
bool
Kötelező

A szolgáltatás Docker-lemezképének törlése. (Alapértelmezett: Hamis)

delete_volume
bool
Kötelező

A szolgáltatás Docker-kötetének törlése. (Alapértelmezett: Igaz)

Kivételek

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

port
int
alapértelmezett érték: None

A helyi port, amelyen elérhetővé szeretné tenni a szolgáltatás HTTP-végpontját.

Válaszok

Egy webszolgáltatás-objektum üzembe helyezésekor használandó konfigurációs objektum.

Visszatérési típus

Kivételek

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
str
alapértelmezett érték: None

Az üzembe helyezett szolgáltatás nevét adja meg. A munkaterületnek egyedinek kell lennie.

deployment_config
WebserviceDeploymentConfiguration
alapértelmezett érték: None

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.

deployment_target
ComputeTarget
alapértelmezett érték: None

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.

Válaszok

Az üzembe helyezett webszolgáltatásnak megfelelő webszolgáltatás-objektum.

Visszatérési típus

Kivételek

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

cls
Kötelező
workspace
Workspace
Kötelező

A webszolgáltatás által regisztrált munkaterület-objektum.

webservice_payload
dict
Kötelező

Egy JSON-objektum, amely webszolgáltatás-objektummá konvertálható.

Kivételek

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

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

Kivételek

azureml.exceptions.NotImplementedError

get_logs

A LocalWebservice naplóinak lekérése.

get_logs(num_lines=5000, raw=False)

Paraméterek

num_lines
int
Kötelező

A beolvasandó naplósorok maximális száma. (Alapértelmezett: 5000)

raw
bool
Kötelező

A nyers Docker-tároló kimenetét adja vissza anélkül, hogy megkísérli formázni. (Alapértelmezett: Hamis)

Válaszok

A LocalWebservice naplói.

Visszatérési típus

str

Kivételek

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

A webszolgáltatás hitelesítési jogkivonata, és azt, hogy mikor kell frissíteni.

Visszatérési típus

Kivételek

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

workspace
Workspace
Kötelező

A LocalWebservices szolgáltatáshoz társított munkaterület-objektum.

model_name
str
alapértelmezett érték: None

A szűrőlista csak az adott modellnévvel üzembe helyezett LocalWebservice-eket tartalmazza.

model_id
str
alapértelmezett érték: None

A szűrőlista csak az adott modellazonosítóval üzembe helyezett LocalWebservice-eket tartalmazza.

all
bool
alapértelmezett érték: None

Az összes szolgáltatás megjelenítése. Alapértelmezés szerint csak a futó szolgáltatások jelennek meg.

Válaszok

A megadott munkaterülethez társított LocalWebservices szűrt listája.

Visszatérési típus

Kivételek

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

key
str
Kötelező

Melyik kulcsot kell újragenerálni. A beállítások az "Elsődleges" vagy a "Másodlagos"

Kivételek

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

wait
bool
Kötelező

Várjon, amíg a szolgáltatás tárolója kifogástalan állapotba ér. (Alapértelmezett: Hamis)

Kivételek

run

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

run(input_data)

Paraméterek

input_data
<xref:varies>
Kötelező

Az a bemenet, amellyel meghívhatja a LocalWebservice szolgáltatást.

Válaszok

A LocalWebservice meghívásának eredménye.

Visszatérési típus

<xref:varies>

Kivételek

serialize

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

serialize()

Válaszok

A Webservice objektum szerializált ábrázolása.

Visszatérési típus

Kivételek

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

models
list[Model]
Kötelező

A LocalWebservice új modelllistája.

image_config
ContainerImageConfig
Kötelező

A LocalWebservice szolgáltatásra alkalmazandó képkonfigurációs beállítások.

deployment_config
LocalWebserviceDeploymentConfiguration
Kötelező

A LocalWebservice szolgáltatásra alkalmazandó üzembehelyezési konfigurációs beállítások.

inference_config
InferenceConfig
Kötelező

Egy InferenceConfig objektum, amely a modell szükséges üzembehelyezési tulajdonságainak megadására szolgál.

wait
bool
Kötelező

Várjon, amíg a szolgáltatás tárolója kifogástalan állapotba ér. (Alapértelmezett: Hamis)

Visszatérési típus

Kivételek

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

must_exist
bool
alapértelmezett érték: False

Azt jelzi, hogy a webszolgáltatásnak már léteznie kell-e a memóriában lévő objektum létrehozásakor.

Kivételek

wait_for_deployment

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

wait_for_deployment(show_output=False)

Paraméterek

show_output
bool
Kötelező

A részletes kimenet nyomtatásának lehetősége. (Alapértelmezett: Hamis)

Kivételek

Attribútumok

port

Szerezze be a helyi webszolgáltatási portot.

Válaszok

Portszám.

Visszatérési típus

int

scoring_uri

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

Válaszok

Pontozási URI.

Visszatérési típus

str

swagger_uri

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

Válaszok

Swagger URI.

Visszatérési típus

str

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'