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

workspace
Workspace
Necessario

Oggetto area di lavoro contenente l'oggetto Webservice da recuperare.

name
str
Necessario

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

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

properties
dict[str, str]
Necessario

Dizionario delle proprietà da aggiungere.

add_tags

Aggiungere coppie di valori chiave al dizionario tag del servizio Web.

add_tags(tags)

Parametri

tags
dict[str, str]
Necessario

Dizionario dei tag da aggiungere.

Eccezioni

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

cpu_cores
float
valore predefinito: None

Numero di core CPU da allocare per questo servizio Web. Può essere un decimale. Impostazione predefinita a 0.1

memory_gb
float
valore predefinito: None

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

tags
dict[str, str]
valore predefinito: None

Dizionario di tag chiave per assegnare questo servizio Web.

properties
dict[str, str]
valore predefinito: None

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.

description
str
valore predefinito: None

Descrizione per assegnare questo servizio Web.

location
str
valore predefinito: None

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.

auth_enabled
bool
valore predefinito: None

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

ssl_enabled
bool
valore predefinito: None

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

enable_app_insights
bool
valore predefinito: None

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

ssl_cert_pem_file
str
valore predefinito: None

Il file di certificato necessario se SSL è abilitato.

ssl_key_pem_file
str
valore predefinito: None

Il file di chiave necessario se SSL è abilitato.

ssl_cname
str
valore predefinito: None

Cname per se SSL è abilitato.

dns_name_label
str
valore predefinito: None

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.

primary_key
str
valore predefinito: None

Chiave di autenticazione primaria da usare per questo servizio Web.

secondary_key
str
valore predefinito: None

Chiave di autenticazione secondaria da usare per questo servizio Web.

collect_model_data
bool
valore predefinito: None

Indica se abilitare o meno la raccolta dati del modello per il servizio Web.

cmk_vault_base_url
str
valore predefinito: None

URL di base dell'insieme di credenziali delle chiavi gestito dal cliente

cmk_key_name
str
valore predefinito: None

nome della chiave gestita dal cliente.

cmk_key_version
str
valore predefinito: None

versione della chiave gestita dal cliente.

vnet_name
str
valore predefinito: None

nome della rete virtuale.

subnet_name
str
valore predefinito: None

nome della subnet all'interno della rete virtuale.

Restituisce

Oggetto di configurazione da usare durante la distribuzione di un oggetto Webservice.

Tipo restituito

AciServiceDeploymentConfiguration

Eccezioni

WebserviceException

get_token

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

Nota

Non implementato.

get_token()

Restituisce

Token di autenticazione per questo servizio Web e quando deve essere aggiornato dopo.

Tipo restituito

str, datetime

Eccezioni

azureml.exceptions.NotImplementedError

remove_tags

Rimuovere le chiavi specificate dal dizionario dei tag del servizio Web.

remove_tags(tags)

Parametri

tags
list[str]
Necessario

Elenco di chiavi da rimuovere.

run

Chiamare questo servizio Web con l'input specificato.

run(input_data)

Parametri

input_data
<xref:varies>
Necessario

Input con cui chiamare il servizio Web.

Restituisce

Risultato della chiamata al servizio Web.

Tipo restituito

dict

Eccezioni

WebserviceException

serialize

Convertire questo servizio Web in un dizionario serializzato JSON.

serialize()

Restituisce

Rappresentazione JSON dell'oggetto Webservice.

Tipo restituito

dict

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

image
Image
valore predefinito: None

Nuova immagine da distribuire nel servizio Web.

tags
dict[str, str]
valore predefinito: None

Dizionario di tag chiave per assegnare questo servizio Web. Sostituirà i tag esistenti.

properties
dict[str, str]
valore predefinito: None

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

description
str
valore predefinito: None

Descrizione per assegnare questo servizio Web.

auth_enabled
bool
valore predefinito: None

Abilitare o disabilitare l'autenticazione per questo servizio Web.

ssl_enabled
bool
valore predefinito: None

Indica se abilitare SSL per questo servizio Web.

ssl_cert_pem_file
str
valore predefinito: None

Il file di certificato necessario se SSL è abilitato.

ssl_key_pem_file
str
valore predefinito: None

Il file di chiave necessario se SSL è abilitato.

ssl_cname
str
valore predefinito: None

Cname per se SSL è abilitato.

enable_app_insights
bool
valore predefinito: None

Indica se abilitare AppInsights per questo servizio Web.

models
list[Model]
valore predefinito: None

Elenco di oggetti Model da creare nel servizio aggiornato.

inference_config
InferenceConfig
valore predefinito: None

Oggetto InferenceConfig usato per fornire le proprietà di distribuzione del modello necessarie.

Tipo restituito

None