LocalWebservice Classe
Rappresenta un modello di Machine Learning distribuito come endpoint servizio Web locale.
La distribuzione dei servizi Web in locale è utile per gli scenari di debug e test.
Costruttore del servizio Web locale.
Il costruttore LocalWebservice viene usato per recuperare una rappresentazione locale di un oggetto LocalWebservice associato all'area di lavoro specificata.
- Ereditarietà
-
LocalWebservice
Costruttore
LocalWebservice(*args, **kwargs)
Parametri
- workspace
- Workspace
Oggetto area di lavoro contenente tutti gli oggetti Model che verranno recuperati.
- must_exist
- bool
Indica se il servizio Web deve esistere già durante la creazione dell'oggetto in memoria.
- workspace
- Workspace
Oggetto area di lavoro contenente tutti gli oggetti Model che verranno recuperati.
- must_exist
- bool
Indica se il servizio Web deve esistere già durante la creazione dell'oggetto in memoria.
Commenti
Gli esempi di codice seguenti illustrano come creare un servizio Web Docker locale. Per altri dettagli, vedere il collegamento al notebook.
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()
L'esempio completo è disponibile da https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/deployment/deploy-to-local/register-model-deploy-local.ipynb
Metodi
delete |
Eliminare questo LocalWebservice dal computer locale. Questa chiamata di funzione non è asincrona; viene eseguito fino a quando il servizio non viene eliminato. |
deploy_configuration |
Creare un oggetto di configurazione per la distribuzione di un servizio Web locale. |
deploy_to_cloud |
Distribuire un servizio Web in base alla configurazione di LocalWebservice. |
deserialize |
Convertire un oggetto JSON di risposta del servizio di gestione modelli in un oggetto Webservice. Nota Non supportato per LocalWebservice. |
get_keys |
Recuperare le chiavi di autenticazione per questo servizio Web. Nota Non supportato per LocalWebservice. |
get_logs |
Recuperare i log per questo LocalWebservice. |
get_token |
Recuperare il token di autenticazione per questo servizio Web, con ambito all'utente corrente. Nota Non supportato per LocalWebservice. |
list |
Elencare i servizi LocalWeb associati all'area di lavoro corrispondente. I risultati restituiti possono essere filtrati usando parametri. |
regen_key |
Rigenerare una delle chiavi del servizio Web. Nota Non supportato per LocalWebservice. |
reload |
Ricaricare lo script di esecuzione e le dipendenze di LocalWebservice. In questo modo il contenitore del servizio viene riavviato con copie di asset aggiornati, inclusi lo script di esecuzione e le dipendenze locali, ma non ricompila l'immagine sottostante. Di conseguenza, le modifiche alle dipendenze Conda/pip o ai passaggi Docker personalizzati non verranno riflesse nel localwebservice ricaricato. Per gestire tali modifiche, chiamare invece il update metodo . |
run |
Chiamare questo LocalWebservice con l'input specificato. |
serialize |
Convertire questo oggetto Webservice in un dizionario serializzato JSON. |
update |
Aggiornare LocalWebservice con le proprietà specificate. I valori lasciati come None rimarranno invariati in questo LocalWebservice. |
update_deployment_state |
Aggiornare lo stato corrente dell'oggetto in memoria. Eseguire un aggiornamento sul posto delle proprietà dell'oggetto in base allo stato corrente del contenitore Docker locale corrispondente. |
wait_for_deployment |
Eseguire il polling della distribuzione LocalWebservice in esecuzione. |
delete
Eliminare questo LocalWebservice dal computer locale.
Questa chiamata di funzione non è asincrona; viene eseguito fino a quando il servizio non viene eliminato.
delete(delete_cache=True, delete_image=False, delete_volume=True)
Parametri
- delete_cache
- bool
Indica se eliminare i file temporanei memorizzati nella cache per il servizio. (Impostazione predefinita: True)
- delete_image
- bool
Indica se eliminare l'immagine Docker del servizio. (Impostazione predefinita: False)
- delete_volume
- bool
Indica se eliminare il volume Docker del servizio. (Impostazione predefinita: True)
Eccezioni
deploy_configuration
Creare un oggetto di configurazione per la distribuzione di un servizio Web locale.
static deploy_configuration(port=None)
Parametri
Restituisce
Oggetto di configurazione da utilizzare per la distribuzione di un oggetto Servizio Web.
Tipo restituito
Eccezioni
deploy_to_cloud
Distribuire un servizio Web in base alla configurazione di LocalWebservice.
deploy_to_cloud(name=None, deployment_config=None, deployment_target=None)
Parametri
- name
- str
Nome da assegnare al servizio distribuito. Deve essere univoco per l'area di lavoro.
- deployment_config
- WebserviceDeploymentConfiguration
Oggetto WebserviceDeploymentConfiguration usato per configurare il servizio Web. Se non ne viene specificato uno, verrà usato un oggetto di configurazione vuoto in base alla destinazione desiderata.
- deployment_target
- ComputeTarget
Oggetto ComputeTarget in cui distribuire il servizio Web. Poiché ACI non ha associato ComputeTarget, lasciare questo parametro come Nessuno per la distribuzione in ACI.
Restituisce
Oggetto Servizio Web corrispondente al servizio Web distribuito.
Tipo restituito
Eccezioni
deserialize
Convertire un oggetto JSON di risposta del servizio di gestione modelli in un oggetto Webservice.
Nota
Non supportato per LocalWebservice.
deserialize(workspace, webservice_payload)
Parametri
- cls
Eccezioni
get_keys
Recuperare le chiavi di autenticazione per questo servizio Web.
Nota
Non supportato per LocalWebservice.
get_keys()
Restituisce
Chiavi di autenticazione per questo servizio Web.
Eccezioni
get_logs
Recuperare i log per questo LocalWebservice.
get_logs(num_lines=5000, raw=False)
Parametri
- num_lines
- int
Numero massimo di righe di log da recuperare. (Impostazione predefinita: 5000)
- raw
- bool
Restituisce l'output del contenitore Docker non elaborato senza tentare di formattarlo. (Impostazione predefinita: False)
Restituisce
Log per questo LocalWebservice.
Tipo restituito
Eccezioni
get_token
Recuperare il token di autenticazione per questo servizio Web, con ambito all'utente corrente.
Nota
Non supportato per LocalWebservice.
get_token()
Restituisce
Token di autenticazione per questo servizio Web e quando deve essere aggiornato dopo.
Tipo restituito
Eccezioni
list
Elencare i servizi LocalWeb associati all'area di lavoro corrispondente.
I risultati restituiti possono essere filtrati usando parametri.
static list(workspace, model_name=None, model_id=None, all=None)
Parametri
- model_name
- str
Elenco di filtri per includere solo LocalWebservices distribuiti con il nome del modello specifico.
- model_id
- str
Elenco di filtri per includere solo LocalWebservices distribuiti con l'ID modello specifico.
- all
- bool
Mostra tutti i servizi. Per impostazione predefinita, vengono visualizzati solo i servizi in esecuzione.
Restituisce
Elenco filtrato di LocalWebservices associati all'area di lavoro specificata.
Tipo restituito
Eccezioni
regen_key
Rigenerare una delle chiavi del servizio Web.
Nota
Non supportato per LocalWebservice.
regen_key(key)
Parametri
Eccezioni
reload
Ricaricare lo script di esecuzione e le dipendenze di LocalWebservice.
In questo modo il contenitore del servizio viene riavviato con copie di asset aggiornati, inclusi lo script di esecuzione e le dipendenze locali, ma non ricompila l'immagine sottostante. Di conseguenza, le modifiche alle dipendenze Conda/pip o ai passaggi Docker personalizzati non verranno riflesse nel localwebservice ricaricato. Per gestire tali modifiche, chiamare invece il update metodo .
reload(wait=False)
Parametri
- wait
- bool
Attendere che il contenitore del servizio raggiunga uno stato integro. (Impostazione predefinita: False)
Eccezioni
run
Chiamare questo LocalWebservice con l'input specificato.
run(input_data)
Parametri
- input_data
- <xref:varies>
Input con cui chiamare LocalWebservice.
Restituisce
Risultato della chiamata a LocalWebservice.
Tipo restituito
Eccezioni
serialize
Convertire questo oggetto Webservice in un dizionario serializzato JSON.
serialize()
Restituisce
Rappresentazione serializzata dell'oggetto Webservice.
Tipo restituito
Eccezioni
update
Aggiornare LocalWebservice con le proprietà specificate.
I valori lasciati come None rimarranno invariati in questo LocalWebservice.
update(models=None, image_config=None, deployment_config=None, wait=False, inference_config=None)
Parametri
- image_config
- ContainerImageConfig
Opzioni di configurazione delle immagini da applicare a LocalWebservice.
- deployment_config
- LocalWebserviceDeploymentConfiguration
Opzioni di configurazione della distribuzione da applicare a LocalWebservice.
- inference_config
- InferenceConfig
Oggetto InferenceConfig usato per fornire le proprietà di distribuzione del modello necessarie.
- wait
- bool
Attendere che il contenitore del servizio raggiunga uno stato integro. (Impostazione predefinita: False)
Tipo restituito
Eccezioni
update_deployment_state
Aggiornare lo stato corrente dell'oggetto in memoria.
Eseguire un aggiornamento sul posto delle proprietà dell'oggetto in base allo stato corrente del contenitore Docker locale corrispondente.
update_deployment_state(must_exist=False)
Parametri
- must_exist
- bool
Indica se il servizio Web deve esistere già durante la creazione dell'oggetto in memoria.
Eccezioni
wait_for_deployment
Eseguire il polling della distribuzione LocalWebservice in esecuzione.
wait_for_deployment(show_output=False)
Parametri
- show_output
- bool
Opzione per stampare un output più dettagliato. (Impostazione predefinita: False)
Eccezioni
Attributi
port
scoring_uri
Ottenere l'URI di assegnazione dei punteggi del servizio Web locale.
Restituisce
URI di assegnazione dei punteggi.
Tipo restituito
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'
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per