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
|
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
|
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
|
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
|
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
|
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 |
|---|---|
|
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
|
Seznam filtrů tak, aby zahrnoval pouze localWebservices nasazené s konkrétním názvem modelu. Default value: None
|
|
model_id
|
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
|
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
scoring_uri
Získejte identifikátor URI bodování místní webové služby.
Návraty
| Typ | Description |
|---|---|
|
Bodovací identifikátor URI. |
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'