LocalWebservice Třída

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

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

Konstruktor místní webové služby.

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

Dědičnost

Webservice

LocalWebservice

Konstruktor

LocalWebservice(*args, **kwargs)

Parametry

Name	Description
workspace Vyžadováno	Workspace Objekt pracovního prostoru obsahující všechny objekty modelu, které budou načteny.
name Vyžadováno	str Název objektu Webservice, který se má načíst.
must_exist Vyžadováno	bool Určuje, zda webová služba již musí existovat při vytváření objektu v paměti.
workspace Vyžadováno	Workspace 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	bool Určuje, 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()

Úplná ukázka je k dispozici na webu https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/deployment/deploy-to-local/register-model-deploy-local.ipynb

Metody

delete	Odstraňte tuto službu LocalWebservice z místního počítače. Toto volání funkce není asynchronní; poběží až do odstranění služby.
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 služby 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číst ověřovací klíče pro tuto webovou službu. Poznámka Nepodporuje se pro LocalWebservice.
get_logs	Načíst protokoly pro tuto službu LocalWebservice.
get_token	Načtěte ověřovací token pro tuto webovou službu s oborem pro aktuálního uživatele. Poznámka Nepodporuje se pro LocalWebservice.
list	Vypište localWebservices přidružené k odpovídajícímu pracovnímu prostoru. Vrácené výsledky je možné 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 neobnoví se základní image. Proto se změny závislostí Conda/pip nebo vlastních kroků Dockeru neprojeví v znovu načtené službě LocalWebservice. Pokud chcete tyto změny zpracovat, volejte místo toho metodu update .
run	Zavolejte tuto službu LocalWebservice se zadaným vstupem.
serialize	Převeďte tento objekt Webové služby na slovník serializovaný ve formátu JSON.
update	Aktualizujte službu LocalWebservice s použitím zadaných vlastností. Hodnoty ponechané jako None zůstanou v této službě 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	Dotaz na spuštěné nasazení LocalWebservice.

delete

Odstraňte tuto službu LocalWebservice z místního počítače.

Toto volání funkce není asynchronní; poběží až do odstranění služby.

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

Parametry

Name	Description
delete_cache Vyžadováno	bool Určuje, jestli se mají odstranit dočasné soubory uložené v mezipaměti pro službu. (Výchozí: True)
delete_image Vyžadováno	bool Jestli se má odstranit image Dockeru služby. (Výchozí: False)
delete_volume Vyžadováno	bool Jestli se má odstranit svazek Dockeru služby. (Výchozí: True)

Výjimky

Typ	Description
WebserviceException

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
LocalWebserviceDeploymentConfiguration	Objekt konfigurace, který se má použít při nasazování objektu Webové služby.

Výjimky

Typ	Description
WebserviceException

deploy_to_cloud

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

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

Parametry

Name	Description
name	str Název, který má dát nasazené službě. Musí být pro pracovní prostor jedinečný. Default value: None
deployment_config	WebserviceDeploymentConfiguration A WebserviceDeploymentConfiguration slouží ke konfiguraci webové služby. Pokud se nezadá, použije se prázdný objekt konfigurace na základě požadovaného cíle. Default value: None
deployment_target	ComputeTarget A ComputeTarget , do kterého chcete nasadit webovou službu. Vzhledem k tomu, že ACI nemá žádný přidružený ComputeTargetparametr , ponechte tento parametr pro nasazení do ACI na hodnotě None. Default value: None

Návraty

Typ	Description
Webservice	Objekt Webservice odpovídající nasazené webové službě.

Výjimky

Typ	Description
WebserviceException

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	Workspace Objekt pracovního prostoru, pod kterým je webová služba zaregistrovaná.
webservice_payload Vyžadováno	dict Objekt JSON, který se má převést na objekt Webservice.

Výjimky

Typ	Description
azureml.exceptions.NotImplementedError

get_keys

Načíst 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číst 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í hodnota: 5000)
raw Vyžadováno	bool Vrátí nezpracovaný výstup kontejneru Dockeru, aniž byste se ho pokusili naformátovat. (Výchozí: False)

Návraty

Typ	Description
str	Protokoly pro tuto službu LocalWebservice.

Výjimky

Typ	Description
WebserviceException

get_token

Načtěte ověřovací token pro tuto webovou službu s oborem pro aktuálního uživatele.

Poznámka

Nepodporuje se pro LocalWebservice.

get_token()

Návraty

Typ	Description
str, datetime	Ověřovací token pro tuto webovou službu a informace o tom, kdy by se měla aktualizovat.

Výjimky

Typ	Description
azureml.exceptions.NotImplementedError

list

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

Vrácené výsledky je možné filtrovat pomocí parametrů.

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

Parametry

Name	Description
workspace Vyžadováno	Workspace Workspace Objekt přidružený k LocalWebservices.
model_name	str Vyfiltrujte seznam tak, aby zahrnoval pouze nasazené služby LocalWeb s konkrétním názvem modelu. Default value: None
model_id	str Vyfiltrujte seznam tak, aby zahrnoval pouze služby LocalWebservices nasazené s konkrétním ID modelu. Default value: None
all	bool 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
list[LocalWebservice]	Filtrovaný seznam služeb LocalWebservices přidružených k zadanému pracovnímu prostoru.

Výjimky

Typ	Description
WebserviceException

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
NotImplementedError

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 neobnoví se základní image. Proto se změny závislostí Conda/pip nebo vlastních kroků Dockeru neprojeví v znovu načtené službě LocalWebservice. Pokud chcete tyto změny zpracovat, volejte místo toho metodu update .

reload(wait=False)

Parametry

Name	Description
wait Vyžadováno	bool Počkejte, až se kontejner služby dostane do stavu v pořádku. (Výchozí: False)

Výjimky

Typ	Description
WebserviceException

run

Zavolejte tuto službu 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
WebserviceException

serialize

Převeďte tento objekt Webové služby na slovník serializovaný ve formátu JSON.

serialize()

Návraty

Typ	Description
dict	Serializovaná reprezentace objektu Webservice.

Výjimky

Typ	Description
WebserviceException

update

Aktualizujte službu LocalWebservice s použitím zadaných vlastností.

Hodnoty ponechané jako None zůstanou v této službě 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	list[Model] Nový seznam modelů obsažených v LocalWebservice.
image_config Vyžadováno	ContainerImageConfig Možnosti konfigurace image, které se mají použít pro LocalWebservice.
deployment_config Vyžadováno	LocalWebserviceDeploymentConfiguration Možnosti konfigurace nasazení, které se mají použít u služby LocalWebservice.
inference_config Vyžadováno	InferenceConfig InferenceConfig Objekt slouží k poskytnutí požadovaných vlastností nasazení modelu.
wait Vyžadováno	bool Počkejte, až se kontejner služby dostane do stavu v pořádku. (Výchozí: False)

Návraty

Typ	Description
None

Výjimky

Typ	Description
WebserviceException

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	bool Určuje, zda webová služba již musí existovat při vytváření objektu v paměti. Default value: False

Výjimky

Typ	Description
WebserviceException

wait_for_deployment

Dotaz na spuštěné nasazení LocalWebservice.

wait_for_deployment(show_output=False)

Parametry

Name	Description
show_output Vyžadováno	bool Možnost tisku podrobnějšího výstupu (Výchozí: False)

Výjimky

Typ	Description
WebserviceException

Atributy

port

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

Návraty

Typ	Description
int	Číslo portu.

scoring_uri

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

Návraty

Typ	Description
str	Identifikátor URI bodování

swagger_uri

Získejte identifikátor URI Swaggeru 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'