AciWebservice Classe

Riferimento

Rappresenta un modello di Machine Learning distribuito come endpoint servizio Web in Istanze di Azure Container.

Un servizio distribuito viene creato da un modello, uno script e i file associati. Il servizio Web risultante è un endpoint HTTP con carico bilanciato con un'API REST. È possibile inviare dati a questa API per ottenere la stima restituita dal modello.

Per altre informazioni, vedere Distribuire un modello in Istanze di Azure Container.

Inizializzare l'istanza del servizio Web.

Il costruttore webservice recupera una rappresentazione cloud di un oggetto Servizio Web associato all'area di lavoro specificata. Restituisce un'istanza di una classe figlio corrispondente al tipo specifico dell'oggetto Webservice recuperato.

Ereditarietà: Webservice

AciWebservice

Costruttore

AciWebservice(workspace, name)

Parametri

Nome	Descrizione
workspace Necessario	Workspace Oggetto workspace contenente l'oggetto Webservice da recuperare.
name Necessario	str Nome dell'oggetto Webservice da recuperare.

Commenti

Il modello di distribuzione consigliato consiste nel creare un oggetto di configurazione della distribuzione con il deploy_configuration metodo e quindi usarlo con il deploy metodo della Model classe, come illustrato di seguito.


   from azureml.core.model import InferenceConfig
   from azureml.core.webservice import AciWebservice


   service_name = 'my-custom-env-service'

   inference_config = InferenceConfig(entry_script='score.py', environment=environment)
   aci_config = AciWebservice.deploy_configuration(cpu_cores=1, memory_gb=1)

   service = Model.deploy(workspace=ws,
                          name=service_name,
                          models=[model],
                          inference_config=inference_config,
                          deployment_config=aci_config,
                          overwrite=True)
   service.wait_for_deployment(show_output=True)

Esistono diversi modi per distribuire un modello come servizio Web, tra cui:

deploy metodo di per i Model modelli già registrati nell'area di lavoro.
deploy_from_image metodo di Webservice.
deploy_from_model metodo di Webservice per i modelli già registrati nell'area di lavoro. Questo metodo creerà un'immagine.
deploy metodo di Webservice, che registrerà un modello e creerà un'immagine.

Per informazioni sull'uso dei servizi Web, vedere

La sezione Variables elenca gli attributi di una rappresentazione locale dell'oggetto AciWebservice cloud. Queste variabili devono essere considerate di sola lettura. La modifica dei valori non verrà riflessa nell'oggetto cloud corrispondente.

Variabili

Nome	Descrizione
enable_app_insights	bool Indica se la registrazione di AppInsights è abilitata per il servizio Web.
cname	str Cname per il servizio Web.
container_resource_requirements	ContainerResourceRequirements Requisiti delle risorse contenitore per il servizio Web.
encryption_properties	EncryptionProperties Proprietà di crittografia per il servizio Web.
vnet_configuration	VnetConfiguration Le proprietà della rete virtuale per il servizio Web, la configurazione deve essere creata e fornita dall'utente.
azureml.core.webservice.AciWebservice.location	str Percorso in cui viene distribuito il servizio Web.
public_ip	str Indirizzo IP pubblico del servizio Web.
azureml.core.webservice.AciWebservice.scoring_uri	str Endpoint di assegnazione dei punteggi per il servizio Web
ssl_enabled	bool Indica se SSL è abilitato o meno per il servizio Web
public_fqdn	str FQDN pubblico per il servizio Web
environment	Environment Oggetto Environment utilizzato per creare il servizio Web
azureml.core.webservice.AciWebservice.models	list[Model] Elenco di modelli distribuiti nel servizio Web
azureml.core.webservice.AciWebservice.swagger_uri	str Endpoint swagger per il servizio Web

Metodi

add_properties	Aggiungere coppie chiave-valore al dizionario delle proprietà di questo servizio Web.
add_tags	Aggiungere coppie chiave-valore al dizionario tag di questo servizio Web.
deploy_configuration	Creare un oggetto di configurazione per la distribuzione di un servizio AciWeb.
get_token	Recuperare il token di autenticazione per questo servizio Web, con ambito all'utente corrente. Nota Non implementato.
remove_tags	Rimuovere le chiavi specificate dal dizionario dei tag di questo servizio Web.
run	Chiamare questo servizio Web con l'input specificato.
serialize	Convertire questo servizio Web in un dizionario serializzato JSON.
update	Aggiornare il servizio Web con le proprietà specificate. I valori lasciati come None rimarranno invariati in questo servizio Web.

add_properties

Aggiungere coppie chiave-valore al dizionario delle proprietà di questo servizio Web.

add_properties(properties)

Parametri

Nome	Descrizione
properties Necessario	dict[str, str] Dizionario delle proprietà da aggiungere.

add_tags

Aggiungere coppie chiave-valore al dizionario tag di questo servizio Web.

add_tags(tags)

Parametri

Nome	Descrizione
tags Necessario	dict[str, str] Dizionario dei tag da aggiungere.

Eccezioni

Tipo	Descrizione
WebserviceException

deploy_configuration

Creare un oggetto di configurazione per la distribuzione di un servizio AciWeb.

static deploy_configuration(cpu_cores=None, memory_gb=None, tags=None, properties=None, description=None, location=None, auth_enabled=None, ssl_enabled=None, enable_app_insights=None, ssl_cert_pem_file=None, ssl_key_pem_file=None, ssl_cname=None, dns_name_label=None, primary_key=None, secondary_key=None, collect_model_data=None, cmk_vault_base_url=None, cmk_key_name=None, cmk_key_version=None, vnet_name=None, subnet_name=None)

Parametri

Nome	Descrizione
cpu_cores	float Numero di core CPU da allocare per questo servizio Web. Può essere un decimale. Il valore predefinito è 0.1 Valore predefinito: None
memory_gb	float Quantità di memoria (in GB) da allocare per questo servizio Web. Può essere un decimale. Il valore predefinito è 0.5 Valore predefinito: None
tags	dict[str, str] Dizionario di tag chiave-valore da assegnare a questo servizio Web. Valore predefinito: None
properties	dict[str, str] Dizionario di proprietà chiave-valore per assegnare questo servizio Web. Queste proprietà non possono essere modificate dopo la distribuzione, ma è possibile aggiungere nuove coppie chiave-valore. Valore predefinito: None
description	str Descrizione da assegnare a questo servizio Web. Valore predefinito: None
location	str L'area di Azure in cui distribuire questo servizio Web. Se non specificata, verrà usata la località dell'area di lavoro. Per altre informazioni sulle aree disponibili, vedere Prodotti per area. Valore predefinito: None
auth_enabled	bool Indica se abilitare o meno l'autenticazione per questo servizio Web. Il valore predefinito è False. Valore predefinito: None
ssl_enabled	bool Indica se abilitare o meno SSL per questo servizio Web. Il valore predefinito è False. Valore predefinito: None
enable_app_insights	bool Indica se abilitare o meno AppInsights per questo servizio Web. Il valore predefinito è False. Valore predefinito: None
ssl_cert_pem_file	str File di certificato necessario se SSL è abilitato. Valore predefinito: None
ssl_key_pem_file	str File di chiave necessario se SSL è abilitato. Valore predefinito: None
ssl_cname	str Cname per se SSL è abilitato. Valore predefinito: None
dns_name_label	str Etichetta del nome DNS per l'endpoint di assegnazione dei punteggi. Se non è specificata un'etichetta di nome DNS univoca, verrà generata per l'endpoint di assegnazione dei punteggi. Valore predefinito: None
primary_key	str Chiave di autenticazione primaria da usare per questo servizio Web. Valore predefinito: None
secondary_key	str Chiave di autenticazione secondaria da usare per questo servizio Web. Valore predefinito: None
collect_model_data	bool Indica se abilitare o meno la raccolta di dati del modello per il servizio Web. Valore predefinito: None
cmk_vault_base_url	str URL di base dell'insieme di credenziali delle chiavi gestito dal cliente Valore predefinito: None
cmk_key_name	str nome della chiave gestita dal cliente. Valore predefinito: None
cmk_key_version	str versione della chiave gestita dal cliente. Valore predefinito: None
vnet_name	str nome della rete virtuale. Valore predefinito: None
subnet_name	str nome della subnet all'interno della rete virtuale. Valore predefinito: None

Restituisce

Tipo	Descrizione
AciServiceDeploymentConfiguration	Oggetto di configurazione da utilizzare per la distribuzione di un oggetto Servizio Web.

Eccezioni

Tipo	Descrizione
WebserviceException

get_token

Recuperare il token di autenticazione per questo servizio Web, con ambito all'utente corrente.

Nota

Non implementato.

get_token()

Restituisce

Tipo	Descrizione
str, datetime	Token di autenticazione per questo servizio Web e quando deve essere aggiornato dopo.

Eccezioni

Tipo	Descrizione
azureml.exceptions.NotImplementedError

remove_tags

Rimuovere le chiavi specificate dal dizionario dei tag di questo servizio Web.

remove_tags(tags)

Parametri

Nome	Descrizione
tags Necessario	list[str] Elenco di chiavi da rimuovere.

run

Chiamare questo servizio Web con l'input specificato.

run(input_data)

Parametri

Nome	Descrizione
input_data Necessario	<xref:varies> Input con cui chiamare il servizio Web.

Restituisce

Tipo	Descrizione
dict	Risultato della chiamata al servizio Web.

Eccezioni

Tipo	Descrizione
WebserviceException

serialize

Convertire questo servizio Web in un dizionario serializzato JSON.

serialize()

Restituisce

Tipo	Descrizione
dict	Rappresentazione JSON di questo oggetto Webservice.

update

Aggiornare il servizio Web con le proprietà specificate.

I valori lasciati come None rimarranno invariati in questo servizio Web.

update(image=None, tags=None, properties=None, description=None, auth_enabled=None, ssl_enabled=None, ssl_cert_pem_file=None, ssl_key_pem_file=None, ssl_cname=None, enable_app_insights=None, models=None, inference_config=None)

Parametri

Nome	Descrizione
image	Image Nuova immagine da distribuire nel servizio Web. Valore predefinito: None
tags	dict[str, str] Dizionario di tag chiave-valore da assegnare a questo servizio Web. Sostituirà i tag esistenti. Valore predefinito: None
properties	dict[str, str] Dizionario di proprietà chiave valore da aggiungere al dizionario delle proprietà esistenti. Valore predefinito: None
description	str Descrizione da assegnare a questo servizio Web. Valore predefinito: None
auth_enabled	bool Abilitare o disabilitare l'autenticazione per questo servizio Web. Valore predefinito: None
ssl_enabled	bool Indica se abilitare o meno SSL per questo servizio Web. Valore predefinito: None
ssl_cert_pem_file	str File di certificato necessario se SSL è abilitato. Valore predefinito: None
ssl_key_pem_file	str File di chiave necessario se SSL è abilitato. Valore predefinito: None
ssl_cname	str Cname per se SSL è abilitato. Valore predefinito: None
enable_app_insights	bool Indica se abilitare o meno AppInsights per questo servizio Web. Valore predefinito: None
models	list[Model] Elenco di oggetti Model da inserire nel servizio aggiornato. Valore predefinito: None
inference_config	InferenceConfig Oggetto InferenceConfig usato per fornire le proprietà di distribuzione del modello necessarie. Valore predefinito: None

Restituisce

Tipo	Descrizione
None

Condividi tramite

AciWebservice Classe

Costruttore

Parametri

Commenti

Variabili

Metodi

add_properties

Parametri

add_tags

Parametri

Eccezioni

deploy_configuration

Parametri

Restituisce

Eccezioni

get_token

Restituisce

Eccezioni

remove_tags

Parametri

run

Parametri

Restituisce

Eccezioni

serialize

Restituisce

update

Parametri

Restituisce

Commenti e suggerimenti

Risorse aggiuntive