LocalWebservice Klasa
Reprezentuje model uczenia maszynowego wdrożony jako lokalny punkt końcowy usługi internetowej.
Lokalne wdrażanie usług internetowych jest przydatne w przypadku scenariuszy debugowania i testowania.
Lokalny konstruktor usługi internetowej.
Konstruktor LocalWebservice służy do pobierania lokalnej reprezentacji obiektu LocalWebservice skojarzonego z podanym obszarem roboczym.
- Dziedziczenie
-
LocalWebservice
Konstruktor
LocalWebservice(*args, **kwargs)
Parametry
- workspace
- Workspace
Obiekt obszaru roboczego zawierający wszystkie obiekty modelu, które zostaną pobrane.
- must_exist
- bool
Czy usługa internetowa musi już istnieć podczas tworzenia obiektu w pamięci.
- workspace
- Workspace
Obiekt obszaru roboczego zawierający wszystkie obiekty modelu, które zostaną pobrane.
- must_exist
- bool
Czy usługa internetowa musi już istnieć podczas tworzenia obiektu w pamięci.
Uwagi
Poniższe przykłady kodu pokazują, jak utworzyć lokalną usługę internetową platformy Docker. Aby uzyskać więcej informacji, zobacz link 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łna próbka jest dostępna w witrynie https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/deployment/deploy-to-local/register-model-deploy-local.ipynb
Metody
delete |
Usuń tę usługę LocalWebservice z komputera lokalnego. To wywołanie funkcji nie jest asynchroniczne; jest uruchamiana do momentu usunięcia usługi. |
deploy_configuration |
Utwórz obiekt konfiguracji na potrzeby wdrażania lokalnej usługi sieci Web. |
deploy_to_cloud |
Wdróż usługę internetową na podstawie konfiguracji localWebservice. |
deserialize |
Przekonwertuj obiekt JSON odpowiedzi usługi zarządzania modelami na obiekt usługi sieci Web. Uwaga Nieobsługiwane w przypadku usługi LocalWebservice. |
get_keys |
Pobierz klucze uwierzytelniania dla tej usługi sieci Web. Uwaga Nieobsługiwane w przypadku usługi LocalWebservice. |
get_logs |
Pobierz dzienniki dla tej usługi LocalWebservice. |
get_token |
Pobierz token uwierzytelniania dla tej usługi sieci Web z zakresem bieżącego użytkownika. Uwaga Nieobsługiwane w przypadku usługi LocalWebservice. |
list |
Wyświetl listę localWebservices skojarzonych z odpowiednim obszarem roboczym. Zwrócone wyniki można filtrować przy użyciu parametrów. |
regen_key |
Wygeneruj ponownie jeden z kluczy usługi internetowej. Uwaga Nieobsługiwane w przypadku usługi LocalWebservice. |
reload |
Załaduj ponownie skrypt wykonywania i zależności usługi LocalWebservice. Spowoduje to ponowne uruchomienie kontenera usługi z kopiami zaktualizowanych zasobów, w tym skryptu wykonywania i zależności lokalnych, ale nie powoduje ponownego skompilowania obrazu bazowego. W związku z tym zmiany zależności conda/pip lub niestandardowe kroki platformy Docker nie zostaną odzwierciedlone w ponownie załadowanej usłudze LocalWebservice. Aby obsłużyć te zmiany, należy zamiast tego wywołać metodę update . |
run |
Wywołaj tę usługę LocalWebservice przy użyciu podanych danych wejściowych. |
serialize |
Przekonwertuj ten obiekt usługi internetowej na słownik serializowany w formacie JSON. |
update |
Zaktualizuj wartość LocalWebservice za pomocą podanych właściwości. Wartości pozostawione jako Brak pozostaną niezmienione w tej lokalnej usłudzeWebservice. |
update_deployment_state |
Odśwież bieżący stan obiektu w pamięci. Przeprowadź aktualizację w miejscu właściwości obiektu na podstawie bieżącego stanu odpowiedniego lokalnego kontenera platformy Docker. |
wait_for_deployment |
Sonduj uruchomione wdrożenie LocalWebservice. |
delete
Usuń tę usługę LocalWebservice z komputera lokalnego.
To wywołanie funkcji nie jest asynchroniczne; jest uruchamiana do momentu usunięcia usługi.
delete(delete_cache=True, delete_image=False, delete_volume=True)
Parametry
- delete_cache
- bool
Czy usunąć pliki tymczasowe buforowane dla usługi. (Wartość domyślna: Prawda)
Wyjątki
deploy_configuration
Utwórz obiekt konfiguracji na potrzeby wdrażania lokalnej usługi sieci Web.
static deploy_configuration(port=None)
Parametry
Zwraca
Obiekt konfiguracji, który ma być używany podczas wdrażania obiektu usługi sieci Web.
Typ zwracany
Wyjątki
deploy_to_cloud
Wdróż usługę internetową na podstawie konfiguracji localWebservice.
deploy_to_cloud(name=None, deployment_config=None, deployment_target=None)
Parametry
- name
- str
Nazwa, która ma nadać wdrożonej usłudze. Musi być unikatowa dla obszaru roboczego.
- deployment_config
- WebserviceDeploymentConfiguration
WebserviceDeploymentConfiguration używana do konfigurowania usługi internetowej. Jeśli go nie podano, pusty obiekt konfiguracji zostanie użyty na podstawie żądanego obiektu docelowego.
- deployment_target
- ComputeTarget
A ComputeTarget , do którego ma zostać wdrożona usługa sieci Web. Ponieważ usługa ACI nie ma skojarzonego ComputeTargetparametru , pozostaw ten parametr jako Brak, aby wdrożyć go w usłudze ACI.
Zwraca
Obiekt usługi sieci Web odpowiadający wdrożonej usłudze internetowej.
Typ zwracany
Wyjątki
deserialize
Przekonwertuj obiekt JSON odpowiedzi usługi zarządzania modelami na obiekt usługi sieci Web.
Uwaga
Nieobsługiwane w przypadku usługi LocalWebservice.
deserialize(workspace, webservice_payload)
Parametry
- cls
- workspace
- Workspace
Obiekt obszaru roboczego, w ramach których zarejestrowano usługę internetową.
Wyjątki
get_keys
Pobierz klucze uwierzytelniania dla tej usługi sieci Web.
Uwaga
Nieobsługiwane w przypadku usługi LocalWebservice.
get_keys()
Zwraca
Klucze uwierzytelniania dla tej usługi sieci Web.
Wyjątki
get_logs
Pobierz dzienniki dla tej usługi LocalWebservice.
get_logs(num_lines=5000, raw=False)
Parametry
- raw
- bool
Zwraca nieprzetworzone dane wyjściowe kontenera platformy Docker bez próby jego sformatowania. (Wartość domyślna: Fałsz)
Zwraca
Dzienniki dla tej usługi LocalWebservice.
Typ zwracany
Wyjątki
get_token
Pobierz token uwierzytelniania dla tej usługi sieci Web z zakresem bieżącego użytkownika.
Uwaga
Nieobsługiwane w przypadku usługi LocalWebservice.
get_token()
Zwraca
Token uwierzytelniania dla tej usługi internetowej i kiedy należy go odświeżyć po.
Typ zwracany
Wyjątki
list
Wyświetl listę localWebservices skojarzonych z odpowiednim obszarem roboczym.
Zwrócone wyniki można filtrować przy użyciu parametrów.
static list(workspace, model_name=None, model_id=None, all=None)
Parametry
- model_name
- str
Filtruj listę, aby uwzględnić tylko usługi LocalWebservices wdrożone z określoną nazwą modelu.
- model_id
- str
Filtruj listę, aby uwzględnić tylko usługi LocalWebservices wdrożone przy użyciu określonego identyfikatora modelu.
- all
- bool
Pokaż wszystkie usługi. Domyślnie wyświetlane są tylko uruchomione usługi.
Zwraca
Filtrowana lista localWebservices skojarzona z podanym obszarem roboczym.
Typ zwracany
Wyjątki
regen_key
Wygeneruj ponownie jeden z kluczy usługi internetowej.
Uwaga
Nieobsługiwane w przypadku usługi LocalWebservice.
regen_key(key)
Parametry
Wyjątki
reload
Załaduj ponownie skrypt wykonywania i zależności usługi LocalWebservice.
Spowoduje to ponowne uruchomienie kontenera usługi z kopiami zaktualizowanych zasobów, w tym skryptu wykonywania i zależności lokalnych, ale nie powoduje ponownego skompilowania obrazu bazowego. W związku z tym zmiany zależności conda/pip lub niestandardowe kroki platformy Docker nie zostaną odzwierciedlone w ponownie załadowanej usłudze LocalWebservice. Aby obsłużyć te zmiany, należy zamiast tego wywołać metodę update .
reload(wait=False)
Parametry
- wait
- bool
Poczekaj, aż kontener usługi osiągnie stan dobrej kondycji. (Wartość domyślna: Fałsz)
Wyjątki
run
Wywołaj tę usługę LocalWebservice przy użyciu podanych danych wejściowych.
run(input_data)
Parametry
- input_data
- <xref:varies>
Dane wejściowe, za pomocą których ma być wywoływana usługa LocalWebservice.
Zwraca
Wynik wywołania localWebservice.
Typ zwracany
Wyjątki
serialize
Przekonwertuj ten obiekt usługi internetowej na słownik serializowany w formacie JSON.
serialize()
Zwraca
Serializowana reprezentacja obiektu usługi internetowej.
Typ zwracany
Wyjątki
update
Zaktualizuj wartość LocalWebservice za pomocą podanych właściwości.
Wartości pozostawione jako Brak pozostaną niezmienione w tej lokalnej usłudzeWebservice.
update(models=None, image_config=None, deployment_config=None, wait=False, inference_config=None)
Parametry
- image_config
- ContainerImageConfig
Opcje konfiguracji obrazu, które mają być stosowane do usługi LocalWebservice.
- deployment_config
- LocalWebserviceDeploymentConfiguration
Opcje konfiguracji wdrożenia, które mają być stosowane do usługi LocalWebservice.
- inference_config
- InferenceConfig
Obiekt InferenceConfig używany do dostarczania wymaganych właściwości wdrożenia modelu.
- wait
- bool
Poczekaj, aż kontener usługi osiągnie stan dobrej kondycji. (Wartość domyślna: Fałsz)
Typ zwracany
Wyjątki
update_deployment_state
Odśwież bieżący stan obiektu w pamięci.
Przeprowadź aktualizację w miejscu właściwości obiektu na podstawie bieżącego stanu odpowiedniego lokalnego kontenera platformy Docker.
update_deployment_state(must_exist=False)
Parametry
- must_exist
- bool
Czy usługa internetowa musi już istnieć podczas tworzenia obiektu w pamięci.
Wyjątki
wait_for_deployment
Sonduj uruchomione wdrożenie LocalWebservice.
wait_for_deployment(show_output=False)
Parametry
- show_output
- bool
Opcja drukowania bardziej pełnych danych wyjściowych. (Wartość domyślna: Fałsz)
Wyjątki
Atrybuty
port
scoring_uri
Pobierz identyfikator URI oceniania lokalnej usługi internetowej.
Zwraca
Identyfikator URI oceniania.
Typ zwracany
swagger_uri
Pobierz identyfikator URI lokalnej usługi internetowej struktury Swagger.
Zwraca
Identyfikator URI struktury Swagger.
Typ zwracany
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'
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla