Sdílet prostřednictvím


LocalWebservice Třída

Představuje model strojového učení nasazený jako místní koncový bod webové služby.

Místní nasazení webových služeb je užitečné pro ladění a testování scénářů.

Místní konstruktor webových služeb.

Konstruktor LocalWebservice slouží k načtení místní reprezentace localWebservice objektu přidruženého k poskytnutému pracovnímu prostoru.

Konstruktor

LocalWebservice(*args, **kwargs)

Parametry

Name Description
workspace
Vyžadováno

Objekt pracovního prostoru obsahující všechny objekty modelu, které budou načteny.

name
Vyžadováno
str

Název objektu webové služby, který se má načíst.

must_exist
Vyžadováno

Zda webová služba již musí existovat při vytváření objektu v paměti.

workspace
Vyžadováno

Objekt pracovního prostoru obsahující všechny objekty modelu, které budou načteny.

name
Vyžadováno
str

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

must_exist
Vyžadováno

Zda webová služba již musí existovat při vytváření objektu v paměti.

Poznámky

Následující ukázky kódu ukazují, jak vytvořit místní webovou službu Dockeru. Další podrobnosti najdete na odkazu na poznámkový blok.


   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()

Metody

delete

Odstraňte tuto localWebservice z místního počítače.

Toto volání funkce není asynchronní; poběží, dokud se služba nespustí.

deploy_configuration

Vytvořte objekt konfigurace pro nasazení místní webové služby.

deploy_to_cloud

Nasaďte webovou službu na základě konfigurace LocalWebservice.

deserialize

Převeďte objekt JSON odpovědi služby Správa modelů na objekt webservice.

Poznámka:

Nepodporuje se pro LocalWebservice.

get_keys

Načtěte ověřovací klíče pro tuto webovou službu.

Poznámka:

Nepodporuje se pro LocalWebservice.

get_logs

Načtěte protokoly pro tuto službu LocalWebservice.

get_token

Načtěte ověřovací token pro tuto webovou službu s vymezeným aktuálním uživatelem.

Poznámka:

Nepodporuje se pro LocalWebservice.

list

Uveďte localWebservices přidružené k odpovídajícímu pracovnímu prostoru.

Vrácené výsledky lze filtrovat pomocí parametrů.

regen_key

Znovu vygenerujte jeden z klíčů webové služby.

Poznámka:

Nepodporuje se pro LocalWebservice.

reload

Znovu načtěte spouštěcí skript a závislosti služby LocalWebservice.

Tím se restartuje kontejner služby s kopiemi aktualizovaných prostředků, včetně spouštěcího skriptu a místních závislostí, ale nevybuduje základní image. Změny závislostí Conda/pip nebo vlastních kroků Dockeru se proto neprojeví v reloaded LocalWebservice. Pokud chcete tyto změny zpracovat, volejte metodu update .

run

Zavolejte tuto LocalWebservice se zadaným vstupem.

serialize

Převeďte tento objekt webové služby na serializovaný slovník JSON.

update

Aktualizujte LocalWebservice zadanými vlastnostmi.

Hodnoty ponechané jako None zůstanou v této LocalWebservice beze změny.

update_deployment_state

Aktualizujte aktuální stav objektu v paměti.

Proveďte místní aktualizaci vlastností objektu na základě aktuálního stavu odpovídajícího místního kontejneru Dockeru.

wait_for_deployment

Dotazujte spuštěné nasazení LocalWebservice.

delete

Odstraňte tuto localWebservice z místního počítače.

Toto volání funkce není asynchronní; poběží, dokud se služba nespustí.

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

Parametry

Name Description
delete_cache
Vyžadováno

Zda chcete odstranit dočasné soubory uložené v mezipaměti pro službu. (Výchozí: Pravda)

delete_image
Vyžadováno

Určuje, jestli chcete odstranit image Dockeru služby. (Výchozí: Nepravda)

delete_volume
Vyžadováno

Jestli chcete odstranit svazek Dockeru služby. (Výchozí: Pravda)

Výjimky

Typ Description

deploy_configuration

Vytvořte objekt konfigurace pro nasazení místní webové služby.

static deploy_configuration(port=None)

Parametry

Name Description
port
int

Místní port, na kterém se má zveřejnit koncový bod HTTP služby.

Default value: None

Návraty

Typ Description

Objekt konfigurace, který se má použít při nasazování objektu webové služby.

Výjimky

Typ Description

deploy_to_cloud

Nasaďte webovou službu na základě konfigurace LocalWebservice.

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

Parametry

Name Description
name
str

Název, který má být nasazenou službou. Musí být jedinečný pro pracovní prostor.

Default value: None
deployment_config

A WebserviceDeploymentConfiguration used to configure the webservice. Pokud ho nezadáte, použije se prázdný objekt konfigurace na základě požadovaného cíle.

Default value: None
deployment_target

A ComputeTarget , do kterého chcete nasadit webovou službu. Vzhledem k tomu, že ACI nemá žádnou přidruženou funkci ComputeTarget, ponechte tento parametr jako None a nasaďte ho do ACI.

Default value: None

Návraty

Typ Description

Objekt webové služby odpovídající nasazené webové službě.

Výjimky

Typ Description

deserialize

Převeďte objekt JSON odpovědi služby Správa modelů na objekt webservice.

Poznámka:

Nepodporuje se pro LocalWebservice.

deserialize(workspace, webservice_payload)

Parametry

Name Description
cls
Vyžadováno
workspace
Vyžadováno

Objekt pracovního prostoru, ve které je webová služba zaregistrovaná.

webservice_payload
Vyžadováno

Objekt JSON, který se má převést na objekt webové služby.

Výjimky

Typ Description
azureml.exceptions.NotImplementedError

get_keys

Načtěte ověřovací klíče pro tuto webovou službu.

Poznámka:

Nepodporuje se pro LocalWebservice.

get_keys()

Návraty

Typ Description

Ověřovací klíče pro tuto webovou službu.

Výjimky

Typ Description
azureml.exceptions.NotImplementedError

get_logs

Načtěte protokoly pro tuto službu LocalWebservice.

get_logs(num_lines=5000, raw=False)

Parametry

Name Description
num_lines
Vyžadováno
int

Maximální počet řádků protokolu, které se mají načíst. (Výchozí: 5000)

raw
Vyžadováno

Vraťte nezpracovaný výstup kontejneru Dockeru, aniž byste se ho pokusili naformátovat. (Výchozí: Nepravda)

Návraty

Typ Description
str

Protokoly pro tuto službu LocalWebservice.

Výjimky

Typ Description

get_token

Načtěte ověřovací token pro tuto webovou službu s vymezeným aktuálním uživatelem.

Poznámka:

Nepodporuje se pro LocalWebservice.

get_token()

Návraty

Typ Description

Ověřovací token pro tuto webovou službu a kdy by se měl aktualizovat.

Výjimky

Typ Description
azureml.exceptions.NotImplementedError

list

Uveďte localWebservices přidružené k odpovídajícímu pracovnímu prostoru.

Vrácené výsledky lze filtrovat pomocí parametrů.

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

Parametry

Name Description
workspace
Vyžadováno

Objekt Pracovního prostoru přidružený k LocalWebservices.

model_name
str

Seznam filtrů tak, aby zahrnoval pouze localWebservices nasazené s konkrétním názvem modelu.

Default value: None
model_id
str

Seznam filtrů tak, aby zahrnoval pouze localWebservices nasazené s konkrétním ID modelu.

Default value: None
all

Zobrazit všechny služby. Ve výchozím nastavení se zobrazují jenom spuštěné služby.

Default value: None

Návraty

Typ Description

Filtrovaný seznam localWebservices přidružených k poskytnutému pracovnímu prostoru.

Výjimky

Typ Description

regen_key

Znovu vygenerujte jeden z klíčů webové služby.

Poznámka:

Nepodporuje se pro LocalWebservice.

regen_key(key)

Parametry

Name Description
key
Vyžadováno
str

Který klíč se má znovu vygenerovat. Možnosti jsou primární nebo sekundární.

Výjimky

Typ Description

reload

Znovu načtěte spouštěcí skript a závislosti služby LocalWebservice.

Tím se restartuje kontejner služby s kopiemi aktualizovaných prostředků, včetně spouštěcího skriptu a místních závislostí, ale nevybuduje základní image. Změny závislostí Conda/pip nebo vlastních kroků Dockeru se proto neprojeví v reloaded LocalWebservice. Pokud chcete tyto změny zpracovat, volejte metodu update .

reload(wait=False)

Parametry

Name Description
wait
Vyžadováno

Počkejte, až se kontejner služby dostane do stavu, který je v pořádku. (Výchozí: Nepravda)

Výjimky

Typ Description

run

Zavolejte tuto LocalWebservice se zadaným vstupem.

run(input_data)

Parametry

Name Description
input_data
Vyžadováno
<xref:varies>

Vstup, se kterým se má volat LocalWebservice.

Návraty

Typ Description
<xref:varies>

Výsledek volání LocalWebservice.

Výjimky

Typ Description

serialize

Převeďte tento objekt webové služby na serializovaný slovník JSON.

serialize()

Návraty

Typ Description

Serializovaná reprezentace objektu webservice.

update

Aktualizujte LocalWebservice zadanými vlastnostmi.

Hodnoty ponechané jako None zůstanou v této LocalWebservice beze změny.

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

Parametry

Name Description
models
Vyžadováno

Nový seznam modelů obsažených v LocalWebservice.

image_config
Vyžadováno

Možnosti konfigurace image, které se mají použít pro LocalWebservice.

deployment_config
Vyžadováno

Možnosti konfigurace nasazení, které se mají použít pro LocalWebservice.

inference_config
Vyžadováno

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

wait
Vyžadováno

Počkejte, až se kontejner služby dostane do stavu, který je v pořádku. (Výchozí: Nepravda)

Návraty

Typ Description

Výjimky

Typ Description

update_deployment_state

Aktualizujte aktuální stav objektu v paměti.

Proveďte místní aktualizaci vlastností objektu na základě aktuálního stavu odpovídajícího místního kontejneru Dockeru.

update_deployment_state(must_exist=False)

Parametry

Name Description
must_exist

Zda webová služba již musí existovat při vytváření objektu v paměti.

Default value: False

wait_for_deployment

Dotazujte spuštěné nasazení LocalWebservice.

wait_for_deployment(show_output=False)

Parametry

Name Description
show_output
Vyžadováno

Možnost tisku více podrobného výstupu (Výchozí: Nepravda)

Výjimky

Typ Description

Atributy

port

Získejte port místní webové služby.

Návraty

Typ Description
int

Číslo portu.

scoring_uri

Získejte identifikátor URI bodování místní webové služby.

Návraty

Typ Description
str

Bodovací identifikátor URI.

swagger_uri

Získejte identifikátor URI Swagger místní webové služby.

Návraty

Typ 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'