LocalWebservice Klas
Vertegenwoordigt een machine learning-model dat is geïmplementeerd als een lokaal webservice-eindpunt.
Het lokaal implementeren van webservices is handig voor foutopsporing en testscenario's.
Lokale webserviceconstructor.
LocalWebservice-constructor wordt gebruikt om een lokale weergave op te halen van een LocalWebservice-object dat is gekoppeld aan de opgegeven werkruimte.
- Overname
-
LocalWebservice
Constructor
LocalWebservice(*args, **kwargs)Parameters
- must_exist
- bool
Of de webservice al moet bestaan bij het maken van het object in het geheugen.
- must_exist
- bool
Of de webservice al moet bestaan bij het maken van het object in het geheugen.
Opmerkingen
In de volgende codevoorbeelden ziet u hoe u een lokale Docker-webservice maakt. Zie de koppeling naar het notitieblok voor meer informatie.
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()
Het volledige voorbeeld is beschikbaar via https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/deployment/deploy-to-local/register-model-deploy-local.ipynb
Methoden
| delete |
Verwijder deze LocalWebservice van de lokale computer. Deze functie-aanroep is niet asynchroon; deze wordt uitgevoerd totdat de service is verwijderd. |
| deploy_configuration |
Maak een configuratieobject voor het implementeren van een lokale webservice. |
| deploy_to_cloud |
Implementeer een webservice op basis van de configuratie van de LocalWebservice. |
| deserialize |
Converteer een JSON-object van een Model Management Service-antwoord naar een webserviceobject. Notitie Niet ondersteund voor LocalWebservice. |
| get_keys |
Verificatiesleutels ophalen voor deze webservice. Notitie Niet ondersteund voor LocalWebservice. |
| get_logs |
Logboeken ophalen voor deze LocalWebservice. |
| get_token |
Verificatietoken ophalen voor deze webservice, met het bereik van de huidige gebruiker. Notitie Niet ondersteund voor LocalWebservice. |
| list |
Vermeld de LocalWebservices die zijn gekoppeld aan de bijbehorende werkruimte. De geretourneerde resultaten kunnen worden gefilterd met behulp van parameters. |
| regen_key |
Genereer een van de sleutels van de webservice opnieuw. Notitie Niet ondersteund voor LocalWebservice. |
| reload |
Laad het uitvoeringsscript en de afhankelijkheden van de LocalWebservice opnieuw. Hiermee wordt de container van de service opnieuw gestart met kopieën van bijgewerkte assets, waaronder het uitvoeringsscript en lokale afhankelijkheden, maar wordt de onderliggende installatiekopieën niet opnieuw opgebouwd. Wijzigingen in Conda/pip-afhankelijkheden of aangepaste Docker-stappen worden daarom niet doorgevoerd in de opnieuw geladen LocalWebservice. Als u deze wijzigingen wilt afhandelen, roept u in plaats daarvan de update methode aan. |
| run |
Roep deze LocalWebservice aan met de opgegeven invoer. |
| serialize |
Converteer dit webserviceobject naar een JSON-geserialiseerde woordenlijst. |
| update |
Werk de LocalWebservice bij met de opgegeven eigenschappen. Waarden die worden achtergelaten als Geen, blijven ongewijzigd in deze LocalWebservice. |
| update_deployment_state |
Vernieuw de huidige status van het object in het geheugen. Voer een in-place update uit van de eigenschappen van het object op basis van de huidige status van de bijbehorende lokale Docker-container. |
| wait_for_deployment |
Peil de actieve LocalWebservice-implementatie. |
delete
Verwijder deze LocalWebservice van de lokale computer.
Deze functie-aanroep is niet asynchroon; deze wordt uitgevoerd totdat de service is verwijderd.
delete(delete_cache=True, delete_image=False, delete_volume=True)Parameters
- delete_cache
- bool
Of tijdelijke bestanden die voor de service in de cache zijn opgeslagen, moeten worden verwijderd. (Standaard: Waar)
- delete_image
- bool
Of de Docker-installatiekopieën van de service moeten worden verwijderd. (Standaard: Onwaar)
- delete_volume
- bool
Of het Docker-volume van de service moet worden verwijderd. (Standaard: Waar)
Uitzonderingen
deploy_configuration
Maak een configuratieobject voor het implementeren van een lokale webservice.
static deploy_configuration(port=None)Parameters
- port
- int
De lokale poort waarop het HTTP-eindpunt van de service beschikbaar wordt gemaakt.
Retouren
Een configuratieobject dat moet worden gebruikt bij het implementeren van een webserviceobject.
Retourtype
Uitzonderingen
deploy_to_cloud
Implementeer een webservice op basis van de configuratie van de LocalWebservice.
deploy_to_cloud(name=None, deployment_config=None, deployment_target=None)Parameters
- name
- str
De naam voor de geïmplementeerde service. Moet uniek zijn voor de werkruimte.
- deployment_config
- WebserviceDeploymentConfiguration
Een WebserviceDeploymentConfiguration die wordt gebruikt om de webservice te configureren. Als er geen wordt opgegeven, wordt een leeg configuratieobject gebruikt op basis van het gewenste doel.
- deployment_target
- ComputeTarget
Een ComputeTarget waarop de webservice moet worden geïmplementeerd. Aangezien ACI geen gekoppeld ComputeTargetheeft, laat u deze parameter op Geen staan om te implementeren in ACI.
Retouren
Een webserviceobject dat overeenkomt met de geïmplementeerde webservice.
Retourtype
Uitzonderingen
deserialize
Converteer een JSON-object van een Model Management Service-antwoord naar een webserviceobject.
Notitie
Niet ondersteund voor LocalWebservice.
deserialize(workspace, webservice_payload)Parameters
- cls
- webservice_payload
- dict
Een JSON-object dat moet worden geconverteerd naar een webserviceobject.
Uitzonderingen
get_keys
Verificatiesleutels ophalen voor deze webservice.
Notitie
Niet ondersteund voor LocalWebservice.
get_keys()Retouren
De verificatiesleutels voor deze webservice.
Uitzonderingen
get_logs
Logboeken ophalen voor deze LocalWebservice.
get_logs(num_lines=5000, raw=False)Parameters
- raw
- bool
Retourneer de uitvoer van de onbewerkte Docker-container zonder deze te formatteren. (Standaard: Onwaar)
Retouren
De logboeken voor deze LocalWebservice.
Retourtype
Uitzonderingen
get_token
Verificatietoken ophalen voor deze webservice, met het bereik van de huidige gebruiker.
Notitie
Niet ondersteund voor LocalWebservice.
get_token()Retouren
Het verificatietoken voor deze webservice en wanneer het daarna moet worden vernieuwd.
Retourtype
Uitzonderingen
list
Vermeld de LocalWebservices die zijn gekoppeld aan de bijbehorende werkruimte.
De geretourneerde resultaten kunnen worden gefilterd met behulp van parameters.
static list(workspace, model_name=None, model_id=None, all=None)Parameters
- model_name
- str
Filter de lijst om alleen LocalWebservices op te nemen die zijn geïmplementeerd met de specifieke modelnaam.
- model_id
- str
Filter de lijst om alleen LocalWebservices op te nemen die zijn geïmplementeerd met de specifieke model-id.
- all
- bool
Alle services weergeven. Standaard worden alleen actieve services weergegeven.
Retouren
Een gefilterde lijst met LocalWebservices die zijn gekoppeld aan de opgegeven werkruimte.
Retourtype
Uitzonderingen
regen_key
Genereer een van de sleutels van de webservice opnieuw.
Notitie
Niet ondersteund voor LocalWebservice.
regen_key(key)Parameters
Uitzonderingen
reload
Laad het uitvoeringsscript en de afhankelijkheden van de LocalWebservice opnieuw.
Hiermee wordt de container van de service opnieuw gestart met kopieën van bijgewerkte assets, waaronder het uitvoeringsscript en lokale afhankelijkheden, maar wordt de onderliggende installatiekopieën niet opnieuw opgebouwd. Wijzigingen in Conda/pip-afhankelijkheden of aangepaste Docker-stappen worden daarom niet doorgevoerd in de opnieuw geladen LocalWebservice. Als u deze wijzigingen wilt afhandelen, roept u in plaats daarvan de update methode aan.
reload(wait=False)Parameters
- wait
- bool
Wacht tot de container van de service een goede status heeft bereikt. (Standaard: Onwaar)
Uitzonderingen
run
Roep deze LocalWebservice aan met de opgegeven invoer.
run(input_data)Parameters
- input_data
- <xref:varies>
De invoer waarmee de LocalWebservice moet worden aangeroepen.
Retouren
Het resultaat van het aanroepen van de LocalWebservice.
Retourtype
Uitzonderingen
serialize
Converteer dit webserviceobject naar een JSON-geserialiseerde woordenlijst.
serialize()Retouren
Geserialiseerde weergave van het webserviceobject.
Retourtype
Uitzonderingen
update
Werk de LocalWebservice bij met de opgegeven eigenschappen.
Waarden die worden achtergelaten als Geen, blijven ongewijzigd in deze LocalWebservice.
update(models=None, image_config=None, deployment_config=None, wait=False, inference_config=None)Parameters
- image_config
- ContainerImageConfig
Configuratieopties voor installatiekopieën die moeten worden toegepast op de LocalWebservice.
- deployment_config
- LocalWebserviceDeploymentConfiguration
Implementatieconfiguratieopties die moeten worden toegepast op de LocalWebservice.
- inference_config
- InferenceConfig
Een InferenceConfig-object dat wordt gebruikt om de vereiste modelimplementatie-eigenschappen te bieden.
- wait
- bool
Wacht tot de container van de service een goede status heeft bereikt. (Standaard: Onwaar)
Retourtype
Uitzonderingen
update_deployment_state
Vernieuw de huidige status van het object in het geheugen.
Voer een in-place update uit van de eigenschappen van het object op basis van de huidige status van de bijbehorende lokale Docker-container.
update_deployment_state(must_exist=False)Parameters
- must_exist
- bool
Of de webservice al moet bestaan bij het maken van het object in het geheugen.
Uitzonderingen
wait_for_deployment
Peil de actieve LocalWebservice-implementatie.
wait_for_deployment(show_output=False)Parameters
Uitzonderingen
Kenmerken
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
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor