Condividi tramite

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 del servizio Web recupera una rappresentazione cloud di un oggetto Webservice associato all'area di lavoro specificata. Restituirà 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 area di lavoro 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 metodo e quindi usarlo con il deploy_configurationdeploy 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 dei modelli già registrati nell'area di Model lavoro.

  • deploy_from_image metodo di Webservice.

  • deploy_from_model metodo di per i modelli già registrati nell'area di Webservice 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 Variabili 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

Se la registrazione di AppInsights è abilitata per il servizio Web.
cname
str

Cname per il servizio Web.
container_resource_requirements
ContainerResourceRequirements

Requisiti delle risorse del 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

Il 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 per il servizio Web
public_fqdn
str

FQDN pubblico per il servizio Web
environment
Environment

Oggetto Environment usato per creare il servizio Web
azureml.core.webservice.AciWebservice.models
list[Model]

Elenco dei modelli distribuiti nel servizio Web
azureml.core.webservice.AciWebservice.swagger_uri
str

Endpoint swagger per il servizio Web

Metodi

add_properties

Aggiungere coppie di valori chiave al dizionario delle proprietà del servizio Web.
add_tags

Aggiungere coppie di valori chiave al dizionario tag del 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 del 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 di valori chiave al dizionario delle proprietà del servizio Web.

add_properties(properties)

Parametri

Nome Descrizione
properties
Necessario
dict[str, str]

Dizionario delle proprietà da aggiungere.

add_tags

Aggiungere coppie di valori chiave al dizionario tag del 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. Impostazione predefinita a 0.1

Valore predefinito: None
memory_gb
float

Quantità di memoria (in GB) da allocare per questo servizio Web. Può essere un decimale. Impostazione predefinita a 0,5

Valore predefinito: None
tags
dict[str, str]

Dizionario di tag chiave per assegnare questo servizio Web.

Valore predefinito: None
properties
dict[str, str]

Dizionario delle proprietà del valore chiave per assegnare questo servizio Web. Queste proprietà non possono essere modificate dopo la distribuzione, ma è possibile aggiungere nuove coppie di valori chiave.

Valore predefinito: None
description
str

Descrizione per assegnare 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 in base all'area.

Valore predefinito: None
auth_enabled
bool

Indica se abilitare l'autenticazione per questo servizio Web. Il valore predefinito è False.

Valore predefinito: None
ssl_enabled
bool

Indica se abilitare SSL per questo servizio Web. Il valore predefinito è False.

Valore predefinito: None
enable_app_insights
bool

Indica se abilitare AppInsights per questo servizio Web. Il valore predefinito è False.

Valore predefinito: None
ssl_cert_pem_file
str

Il file di certificato necessario se SSL è abilitato.

Valore predefinito: None
ssl_key_pem_file
str

Il 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 è stata 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 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 usare durante la distribuzione di un oggetto Webservice.

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 del 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 dell'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 per assegnare questo servizio Web. Sostituirà i tag esistenti.

Valore predefinito: None
properties
dict[str, str]

Dizionario delle proprietà chiave valore da aggiungere al dizionario delle proprietà esistenti.

Valore predefinito: None
description
str

Descrizione per assegnare 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 SSL per questo servizio Web.

Valore predefinito: None
ssl_cert_pem_file
str

Il file di certificato necessario se SSL è abilitato.

Valore predefinito: None
ssl_key_pem_file
str

Il 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 AppInsights per questo servizio Web.

Valore predefinito: None
models
list[Model]

Elenco di oggetti Model da creare 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