LocalWebservice Klasa

Przedstawia model uczenia maszynowego wdrożony jako lokalny punkt końcowy usługi sieci Web.

Wdrażanie usług sieci Web lokalnie jest przydatne w scenariuszach debugowania i testowania.

Dziedziczenie
LocalWebservice

Konstruktor

LocalWebservice(workspace, name, must_exist=True)

Parametry

workspace
Workspace

Obiekt obszaru roboczego zawierający wszystkie obiekty modelu, które zostaną pobrane.

name
<xref:str>

Nazwa obiektu usługi WebService do pobrania.

must_exist
<xref:bool>

Czy usługa WebService musi już istnieć podczas tworzenia obiektu znajdującego się w pamięci.

Uwagi

Poniższy przykład kodu przedstawia sposób tworzenia lokalnej usługi sieci Web platformy Docker. Aby uzyskać więcej informacji, zobacz link do notesu.


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

Pełny przykład jest dostępny z https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/deployment/deploy-to-local/register-model-deploy-local.ipynb

Metody

delete

Usuń ten LocalWebservice z komputera lokalnego.

To wywołanie funkcji nie jest asynchroniczne; działa do momentu usunięcia usługi.

deploy_configuration

Utwórz obiekt konfiguracji do wdrożenia lokalnej usługi sieci Web.

deploy_to_cloud

Wdróż usługę sieci Web na podstawie konfiguracji LocalWebservice.

deserialize

Przekonwertuj obiekt JSON odpowiedzi usługi Zarządzanie modelami na obiekt WebService.

Uwaga

Nieobsługiwane w przypadku LocalWebservice.

get_keys

Pobierz klucze uwierzytelniania dla tej usługi sieci Web.

Uwaga

Nieobsługiwane w przypadku LocalWebservice.

get_logs

Pobierz dzienniki dla tego LocalWebservice.

get_token

Pobierz token uwierzytelniania dla tej usługi sieci Web w zakresie bieżącego użytkownika.

Uwaga

Nieobsługiwane w przypadku LocalWebservice.

list

Wyświetl listę LocalWebservices skojarzonych z odpowiednim obszarem roboczym.

Zwracane wyniki można filtrować przy użyciu parametrów.

regen_key

Wygeneruj ponownie jeden z kluczy usługi WebService.

Uwaga

Nieobsługiwane w przypadku LocalWebservice.

reload

Załaduj ponownie skrypt i zależności wykonywania LocalWebservice.

Spowoduje to ponowne uruchomienie kontenera usługi z kopiami zaktualizowanych zasobów, w tym skryptem wykonania i lokalnymi zależnościami, ale nie spowoduje odbudowania bazowego obrazu. W związku z tym zmiany dotyczące zależności Conda/PIP lub niestandardowych kroków platformy Docker nie zostaną odzwierciedlone w ponownie załadowanym LocalWebservice. Aby obsłużyć te zmiany, update zamiast tego wywołaj metodę.

run

Wywołaj ten LocalWebservice z dostarczonymi danymi wejściowymi.

serialize

Przekonwertuj ten obiekt usługi WebService do słownika serializowanego JSON.

update

Zaktualizuj LocalWebservice z użyciem podanych właściwości.

Wartości pozostawione jako brak pozostaną bez zmian w tym LocalWebservice.

update_deployment_state

Odśwież bieżący stan obiektu znajdującego się w pamięci.

Wykonaj aktualizację w miejscu właściwości obiektu na podstawie bieżącego stanu odpowiedniego lokalnego kontenera Docker.

wait_for_deployment

Sondowanie działającego wdrożenia LocalWebservice.

delete

Usuń ten LocalWebservice z komputera lokalnego.

To wywołanie funkcji nie jest asynchroniczne; działa do momentu usunięcia usługi.

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

Parametry

delete_cache
<xref:bool>

Określa, czy usuwać pliki tymczasowe buforowane dla usługi. (Wartość domyślna: true)

delete_image
<xref:bool>

Określa, czy należy usunąć obraz platformy Docker usługi. (Wartość domyślna: false)

delete_volume
<xref:bool>

Określa, czy należy usunąć wolumin platformy Docker usługi. (Wartość domyślna: true)

Wyjątki

deploy_configuration

Utwórz obiekt konfiguracji do wdrożenia lokalnej usługi sieci Web.

deploy_configuration(port=None)

Parametry

port
<xref:int>
wartość domyślna: None

Port lokalny, na którym ma zostać ujawniony punkt końcowy HTTP usługi.

Zwraca

Obiekt konfiguracji, który ma być używany podczas wdrażania obiektu usługi WebService.

Typ zwracany

Wyjątki

deploy_to_cloud

Wdróż usługę sieci Web na podstawie konfiguracji LocalWebservice.

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

Parametry

name
<xref:str>
wartość domyślna: None

Nazwa do nadania wdrożonej usłudze. Musi być unikatowy dla obszaru roboczego.

deployment_config
WebserviceDeploymentConfiguration
wartość domyślna: None

WebserviceDeploymentConfiguration używany do konfigurowania usługi sieci Web. Jeśli nie zostanie podany, zostanie użyty pusty obiekt konfiguracji w oparciu o żądany element docelowy.

deployment_target
ComputeTarget
wartość domyślna: None

A, ComputeTarget do którego ma zostać wdrożona usługa sieci Web. Ponieważ ACI nie ma skojarzonego ComputeTarget , pozostaw ten parametr jako brak do wdrożenia na ACI.

Zwraca

Obiekt usługi WebService odpowiadający wdrożonej usłudze sieci Web.

Typ zwracany

Wyjątki

deserialize

Przekonwertuj obiekt JSON odpowiedzi usługi Zarządzanie modelami na obiekt WebService.

Uwaga

Nieobsługiwane w przypadku LocalWebservice.

deserialize(workspace, webservice_payload)

Parametry

cls
workspace
Workspace

Obiekt obszaru roboczego, w ramach którego zarejestrowano usługę sieci Web.

webservice_payload
<xref:dict>

Obiekt JSON do przekonwertowania na obiekt usługi WebService.

Wyjątki

get_keys

Pobierz klucze uwierzytelniania dla tej usługi sieci Web.

Uwaga

Nieobsługiwane w przypadku LocalWebservice.

get_keys()

Zwraca

Klucze uwierzytelniania dla tej usługi sieci Web.

Wyjątki

get_logs

Pobierz dzienniki dla tego LocalWebservice.

get_logs(num_lines=5000, raw=False)

Parametry

num_lines
<xref:int>

Maksymalna liczba wierszy dziennika do pobrania. (Domyślnie: 5000)

raw
<xref:bool>

Zwróć pierwotne wyjście kontenera platformy Docker bez próby jego sformatowania. (Wartość domyślna: false)

Zwraca

Dzienniki dla tego LocalWebservice.

Typ zwracany

<xref:str>

Wyjątki

get_token

Pobierz token uwierzytelniania dla tej usługi sieci Web w zakresie bieżącego użytkownika.

Uwaga

Nieobsługiwane w przypadku LocalWebservice.

get_token()

Zwraca

Token uwierzytelniania dla tej usługi sieci Web i kiedy powinien być odświeżany po.

Typ zwracany

<xref:str>, <xref:datetime>

Wyjątki

list

Wyświetl listę LocalWebservices skojarzonych z odpowiednim obszarem roboczym.

Zwracane wyniki można filtrować przy użyciu parametrów.

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

Parametry

workspace
Workspace

Obiekt obszaru roboczego skojarzony z LocalWebservices.

model_name
<xref:str>
wartość domyślna: None

Lista filtrów obejmująca tylko LocalWebservices wdrożonych z określoną nazwą modelu.

model_id
<xref:str>
wartość domyślna: None

Lista filtrów obejmująca tylko LocalWebservices wdrożonych z określonym IDENTYFIKATORem modelu.

all
<xref:bool>
wartość domyślna: None

Pokaż wszystkie usługi. Domyślnie są wyświetlane tylko uruchomione usługi.

Zwraca

Filtrowana lista LocalWebservices skojarzonych z udostępnionym obszarem roboczym.

Typ zwracany

Wyjątki

regen_key

Wygeneruj ponownie jeden z kluczy usługi WebService.

Uwaga

Nieobsługiwane w przypadku LocalWebservice.

regen_key(key)

Parametry

key
<xref:str>

Klucz do ponownego wygenerowania. Dostępne opcje to "podstawowa" lub "pomocnicza"

Wyjątki

reload

Załaduj ponownie skrypt i zależności wykonywania LocalWebservice.

Spowoduje to ponowne uruchomienie kontenera usługi z kopiami zaktualizowanych zasobów, w tym skryptem wykonania i lokalnymi zależnościami, ale nie spowoduje odbudowania bazowego obrazu. W związku z tym zmiany dotyczące zależności Conda/PIP lub niestandardowych kroków platformy Docker nie zostaną odzwierciedlone w ponownie załadowanym LocalWebservice. Aby obsłużyć te zmiany, update zamiast tego wywołaj metodę.

reload(wait=False)

Parametry

wait
<xref:bool>

Poczekaj, aż kontener usługi osiągnie stan prawidłowy. (Wartość domyślna: false)

Wyjątki

run

Wywołaj ten LocalWebservice z dostarczonymi danymi wejściowymi.

run(input_data)

Parametry

input_data
<xref:varies>

Dane wejściowe, z których ma zostać wywołana LocalWebservice.

Zwraca

Wynik wywołania LocalWebservice.

Typ zwracany

<xref:varies>

Wyjątki

serialize

Przekonwertuj ten obiekt usługi WebService do słownika serializowanego JSON.

serialize()

Zwraca

Serializowana reprezentacja obiektu usługi WebService.

Typ zwracany

<xref:dict>

Wyjątki

update

Zaktualizuj LocalWebservice z użyciem podanych właściwości.

Wartości pozostawione jako brak pozostaną bez zmian w tym LocalWebservice.

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

Parametry

models
list[Model]

Nowa lista modeli zawartych w LocalWebservice.

image_config
ContainerImageConfig

Opcje konfiguracji obrazu, które mają zostać zastosowane do LocalWebservice.

deployment_config
LocalWebserviceDeploymentConfiguration

Opcje konfiguracji wdrożenia, które mają zostać zastosowane do LocalWebservice.

inference_config
InferenceConfig

Obiekt InferenceConfig używany do zapewnienia wymaganych właściwości wdrożenia modelu.

wait
<xref:bool>

Poczekaj, aż kontener usługi osiągnie stan prawidłowy. (Wartość domyślna: false)

Typ zwracany

<xref:None>

Wyjątki

update_deployment_state

Odśwież bieżący stan obiektu znajdującego się w pamięci.

Wykonaj aktualizację w miejscu właściwości obiektu na podstawie bieżącego stanu odpowiedniego lokalnego kontenera Docker.

update_deployment_state(must_exist=False)

Parametry

must_exist
<xref:bool>
wartość domyślna: False

Czy usługa WebService musi już istnieć podczas tworzenia obiektu znajdującego się w pamięci.

Wyjątki

wait_for_deployment

Sondowanie działającego wdrożenia LocalWebservice.

wait_for_deployment(show_output=False)

Parametry

show_output
<xref:bool>

Opcja drukowania bardziej szczegółowych danych wyjściowych. (Wartość domyślna: false)

Wyjątki

Atrybuty

port

Pobierz lokalny Port usługi WebService.

Zwraca

Numer portu.

Typ zwracany

<xref:int>

scoring_uri

Pobierz identyfikator URI lokalnego oceniania usługi WebService.

Zwraca

Identyfikator URI oceniania.

Typ zwracany

<xref:str>

swagger_uri

Pobierz identyfikator URI usługi WebService w sieci Web.

Zwraca

Identyfikator URI struktury Swagger.

Typ zwracany

<xref: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'