LocalWebservice Klass
Representerar en maskininlärningsmodell som distribuerats som en lokal webbtjänstslutpunkt.
Att distribuera webbtjänster lokalt är användbart för felsökning och testning.
Lokal webbtjänstkonstruktor.
LocalWebservice-konstruktorn används för att hämta en lokal representation av ett LocalWebservice-objekt som är associerat med den angivna arbetsytan.
- Arv
-
LocalWebservice
Konstruktor
LocalWebservice(*args, **kwargs)
Parametrar
- must_exist
- bool
Om webbtjänsten redan måste finnas när du skapar det minnesinterna objektet.
- must_exist
- bool
Om webbtjänsten redan måste finnas när du skapar det minnesinterna objektet.
Kommentarer
Följande kodexempel visar hur du skapar en lokal Docker-webbtjänst. Mer information finns i notebook-länken.
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()
Fullständigt exempel är tillgängligt från https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/deployment/deploy-to-local/register-model-deploy-local.ipynb
Metoder
delete |
Ta bort den här LocalWebservice från den lokala datorn. Det här funktionsanropet är inte asynkront. den körs tills tjänsten tas bort. |
deploy_configuration |
Skapa ett konfigurationsobjekt för att distribuera en lokal webbtjänst. |
deploy_to_cloud |
Distribuera en webbtjänst baserat på LocalWebservices konfiguration. |
deserialize |
Konvertera ett JSON-objekt för modellhanteringstjänstens svar till ett webbtjänstobjekt. Anteckning Stöds inte för LocalWebservice. |
get_keys |
Hämta autentiseringsnycklar för den här webbtjänsten. Anteckning Stöds inte för LocalWebservice. |
get_logs |
Hämta loggar för den här LocalWebservice. |
get_token |
Hämta autentiseringstoken för den här webbtjänsten, begränsad till den aktuella användaren. Anteckning Stöds inte för LocalWebservice. |
list |
Ange de LocalWebservices som är associerade med motsvarande arbetsyta. Resultaten som returneras kan filtreras med hjälp av parametrar. |
regen_key |
Återskapa en av webbtjänstens nycklar. Anteckning Stöds inte för LocalWebservice. |
reload |
Läsa in LocalWebservices körningsskript och beroenden igen. Detta startar om tjänstens container med kopior av uppdaterade tillgångar, inklusive körningsskriptet och lokala beroenden, men den återskapar inte den underliggande avbildningen. Därför återspeglas inte ändringar i Conda/pip-beroenden eller anpassade Docker-steg i den omlästa LocalWebservice. Om du vill hantera dessa ändringar anropar du update metoden i stället. |
run |
Anropa den här LocalWebservice med angivna indata. |
serialize |
Konvertera det här webbtjänstobjektet till en JSON-serialiserad ordlista. |
update |
Uppdatera LocalWebservice med angivna egenskaper. Värden kvar som Ingen förblir oförändrade i den här LocalWebservice. |
update_deployment_state |
Uppdatera det aktuella tillståndet för det minnesinterna objektet. Utför en uppdatering på plats av egenskaperna för objektet baserat på aktuellt tillstånd för motsvarande lokala Docker-container. |
wait_for_deployment |
Avsök localwebservice-distributionen som körs. |
delete
Ta bort den här LocalWebservice från den lokala datorn.
Det här funktionsanropet är inte asynkront. den körs tills tjänsten tas bort.
delete(delete_cache=True, delete_image=False, delete_volume=True)
Parametrar
- delete_cache
- bool
Om du vill ta bort temporära filer som cachelagrats för tjänsten. (Standard: Sant)
Undantag
deploy_configuration
Skapa ett konfigurationsobjekt för att distribuera en lokal webbtjänst.
static deploy_configuration(port=None)
Parametrar
Returer
Ett konfigurationsobjekt som ska användas när ett webbtjänstobjekt distribueras.
Returtyp
Undantag
deploy_to_cloud
Distribuera en webbtjänst baserat på LocalWebservices konfiguration.
deploy_to_cloud(name=None, deployment_config=None, deployment_target=None)
Parametrar
- deployment_config
- WebserviceDeploymentConfiguration
En WebserviceDeploymentConfiguration som används för att konfigurera webbtjänsten. Om inget anges används ett tomt konfigurationsobjekt baserat på önskat mål.
- deployment_target
- ComputeTarget
En ComputeTarget som webbtjänsten ska distribueras till. Eftersom ACI inte har någon associerad ComputeTargetlämnar du den här parametern som Ingen att distribuera till ACI.
Returer
Ett webbtjänstobjekt som motsvarar den distribuerade webbtjänsten.
Returtyp
Undantag
deserialize
Konvertera ett JSON-objekt för modellhanteringstjänstens svar till ett webbtjänstobjekt.
Anteckning
Stöds inte för LocalWebservice.
deserialize(workspace, webservice_payload)
Parametrar
- cls
Undantag
get_keys
Hämta autentiseringsnycklar för den här webbtjänsten.
Anteckning
Stöds inte för LocalWebservice.
get_keys()
Returer
Autentiseringsnycklarna för den här webbtjänsten.
Undantag
get_logs
Hämta loggar för den här LocalWebservice.
get_logs(num_lines=5000, raw=False)
Parametrar
- raw
- bool
Returnera dockercontainerns råutdata utan att försöka formatera den. (Standard: Falskt)
Returer
Loggarna för den här LocalWebservice.
Returtyp
Undantag
get_token
Hämta autentiseringstoken för den här webbtjänsten, begränsad till den aktuella användaren.
Anteckning
Stöds inte för LocalWebservice.
get_token()
Returer
Autentiseringstoken för den här webbtjänsten och när den ska uppdateras efter.
Returtyp
Undantag
list
Ange de LocalWebservices som är associerade med motsvarande arbetsyta.
Resultaten som returneras kan filtreras med hjälp av parametrar.
static list(workspace, model_name=None, model_id=None, all=None)
Parametrar
- model_name
- str
Filterlista för att endast inkludera LocalWebservices som distribuerats med det specifika modellnamnet.
- model_id
- str
Filterlista för att endast inkludera LocalWebservices som distribuerats med det specifika modell-ID:t.
Returer
En filtrerad lista över LocalWebservices som är associerade med den angivna arbetsytan.
Returtyp
Undantag
regen_key
Återskapa en av webbtjänstens nycklar.
Anteckning
Stöds inte för LocalWebservice.
regen_key(key)
Parametrar
Undantag
reload
Läsa in LocalWebservices körningsskript och beroenden igen.
Detta startar om tjänstens container med kopior av uppdaterade tillgångar, inklusive körningsskriptet och lokala beroenden, men den återskapar inte den underliggande avbildningen. Därför återspeglas inte ändringar i Conda/pip-beroenden eller anpassade Docker-steg i den omlästa LocalWebservice. Om du vill hantera dessa ändringar anropar du update metoden i stället.
reload(wait=False)
Parametrar
- wait
- bool
Vänta tills tjänstens container når ett felfritt tillstånd. (Standard: Falskt)
Undantag
run
Anropa den här LocalWebservice med angivna indata.
run(input_data)
Parametrar
- input_data
- <xref:varies>
De indata som localwebservice ska anropas med.
Returer
Resultatet av att anropa LocalWebservice.
Returtyp
Undantag
serialize
Konvertera det här webbtjänstobjektet till en JSON-serialiserad ordlista.
serialize()
Returer
Serialiserad representation av webbtjänstobjektet.
Returtyp
Undantag
update
Uppdatera LocalWebservice med angivna egenskaper.
Värden kvar som Ingen förblir oförändrade i den här LocalWebservice.
update(models=None, image_config=None, deployment_config=None, wait=False, inference_config=None)
Parametrar
- image_config
- ContainerImageConfig
Bildkonfigurationsalternativ som ska tillämpas på LocalWebservice.
- deployment_config
- LocalWebserviceDeploymentConfiguration
Distributionskonfigurationsalternativ som ska tillämpas på LocalWebservice.
- inference_config
- InferenceConfig
Ett InferenceConfig-objekt som används för att tillhandahålla de nödvändiga modelldistributionsegenskaperna.
- wait
- bool
Vänta tills tjänstens container har ett felfritt tillstånd. (Standard: Falskt)
Returtyp
Undantag
update_deployment_state
Uppdatera det aktuella tillståndet för det minnesinterna objektet.
Utför en uppdatering på plats av egenskaperna för objektet baserat på aktuellt tillstånd för motsvarande lokala Docker-container.
update_deployment_state(must_exist=False)
Parametrar
- must_exist
- bool
Om webbtjänsten redan måste finnas när du skapar det minnesinterna objektet.
Undantag
wait_for_deployment
Avsök localwebservice-distributionen som körs.
wait_for_deployment(show_output=False)
Parametrar
Undantag
Attribut
port
scoring_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'
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för