Freigeben über

Webservice Klasse

  • Referenz

Definiert Basisfunktionen für die Bereitstellung von Modellen als Webdienst-Endpunkte in Azure Machine Learning.

Der Webdienstkonstruktor wird verwendet, um eine Clouddarstellung eines Webservice-Objekts abzurufen, das dem bereitgestellten Workspace-Objekt zugeordnet ist. Gibt eine Instanz einer untergeordneten Klasse zurück, die dem spezifischen Typ des abgerufenen Webservice-Objekts entspricht Die Webservice-Klasse ermöglicht die Bereitstellung von Machine Learning-Modellen aus einem Model- oder Image-Objekt.

Weitere Informationen zur Verwendung von Webservice finden Sie unter Bereitstellen von Modellen mit Azure Machine Learning.

Initialisieren Sie den Webdienst instance.

Der Webdienstkonstruktor ruft eine Clouddarstellung eines Webdienstobjekts ab, das dem bereitgestellten Arbeitsbereich zugeordnet ist. Es wird eine instance einer untergeordneten Klasse zurückgegeben, die dem spezifischen Typ des abgerufenen Webdienstobjekts entspricht.

Vererbung
ABC
Webservice

Konstruktor

Webservice(workspace, name)

Parameter

Name Beschreibung
workspace
Erforderlich
Workspace

Das Arbeitsbereichsobjekt, das das abzurufende Webdienstobjekt enthält.
name
Erforderlich
str

Der Name des abzurufenden Webdienstobjekts.
workspace
Erforderlich
Workspace

Das Arbeitsbereichsobjekt, das das abzurufende Webdienstobjekt enthält.
name
Erforderlich
str

Der Name des abzurufenden Webdienstobjekts.

Hinweise

Das folgende Beispiel zeigt das empfohlene Bereitstellungsmuster, bei dem Sie zunächst ein Konfigurationsobjekt mit der deploy_configuration-Methode der untergeordneten Klasse von Webdienst (in diesem Fall AksWebservice) erstellen und dann die Konfiguration mit der deploy-Methode der Model-Klasse verwenden.


   # Set the web service configuration (using default here)
   aks_config = AksWebservice.deploy_configuration()

   # # Enable token auth and disable (key) auth on the webservice
   # aks_config = AksWebservice.deploy_configuration(token_auth_enabled=True, auth_enabled=False)

Das vollständige Beispiel finden Sie unter https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/deployment/production-deploy-to-aks/production-deploy-to-aks.ipynb.

Im folgenden Beispiel wird gezeigt, wie Sie einen vorhandenen AciWebservice in einem Arbeitsbereich suchen und, sofern vorhanden, löschen, damit der Name wiederverwendet werden kann.


   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)

Es gibt eine Reihe von Möglichkeiten, ein Modell als Webdienst bereitzustellen, darunter die folgenden:

  • deploy-Methode des Model für bereits im Arbeitsbereich registrierte Modelle.

  • deploy_from_image-Methode des Webservice für bereits aus einem Modell erstellte Images.

  • deploy_from_model-Methode des Webservice für bereits im Arbeitsbereich registrierte Modelle. Mit dieser Methode wird ein Image erstellt.

  • deploy-Methode des Webservice, mit der ein Modell registriert und ein Image erstellt wird.

Informationen zum Arbeiten mit Webdiensten finden Sie unter

Im Abschnitt Variablen werden Attribute einer lokalen Darstellung des Cloud-Webdienstobjekts aufgeführt. Diese Variablen sollten als schreibgeschützt betrachtet werden. Das Ändern ihrer Werte wird im entsprechenden Cloudobjekt nicht widergespiegelt.

Variablen

Name Beschreibung
auth_enabled
bool

Gibt an, ob für den Webdienst die Authentifizierung aktiviert ist.
compute_type
str

Gibt den Computetyp an, für den der Webdienst bereitgestellt wird.
created_time
datetime

Gibt den Zeitpunkt der Erstellung des Webdiensts an.
azureml.core.Webservice.description

Eine Beschreibung des Webdienstobjekts.
azureml.core.Webservice.tags

Ein Wörterbuch mit Tags für das Webdienstobjekt.
azureml.core.Webservice.name

Der Name des Webdiensts.
azureml.core.Webservice.properties

Wörterbuch der Schlüssel-Wert-Eigenschaften für den Webdienst. Diese Eigenschaften können nach der Bereitstellung nicht mehr geändert werden. Es können jedoch neue Schlüssel-Wert-Paare hinzugefügt werden.
created_by
str

Der Benutzer, der den Webdienst erstellt hat.
error
str

Wenn bei der Bereitstellung des Webdiensts ein Fehler aufgetreten ist, ist hier die Fehlermeldung enthalten, warum der Fehler aufgetreten ist.
azureml.core.Webservice.state

Der aktuelle Zustand des Webdiensts.
updated_time
datetime

Der Zeitpunkt der letzten Aktualisierung des Webdiensts.
azureml.core.Webservice.workspace

Der Azure Machine Learning-Arbeitsbereich, der diesen Webdienst enthält.
token_auth_enabled
bool

Gibt an, ob für den Webdienst die Tokenauthentifizierung aktiviert ist.

Methoden

check_for_existing_webservice

Überprüfen Sie, ob der Webdienst vorhanden ist.
delete

Löschen Sie diesen Webdienst aus dem zugeordneten Arbeitsbereich.

Dieser Funktionsaufruf ist nicht asynchron. Der Aufruf wird ausgeführt, bis die Ressource gelöscht ist. Eine WebserviceException wird ausgelöst, wenn ein Problem beim Löschen des Modells aus dem Modellverwaltungsdienst besteht.
deploy

Stellen Sie einen Webdienst aus null oder mehr Model-Objekten bereit.

Diese Funktion registriert alle bereitgestellten Modelldateien und erstellt im Prozess ein Image, das dem angegebenen Workspace zugeordnet ist. Verwenden Sie diese Funktion, wenn Sie über ein Verzeichnis mit bereitzustellenden Modellen verfügen, die noch nicht registriert wurden.

Der resultierende Webdienst ist ein Echtzeitendpunkt, der für Rückschlussanforderungen verwendet werden kann. Weitere Informationen finden Sie unter Nutzen eines als Webdienst bereitgestellten Modells.
deploy_from_image

Stellen Sie einen Webdienst aus einem Image-Objekt bereit.

Verwenden Sie diese Funktion, wenn Sie bereits ein Image-Objekt für ein Modell erstellt haben.

Der resultierende Webdienst ist ein Echtzeitendpunkt, der für Rückschlussanforderungen verwendet werden kann. Weitere Informationen finden Sie unter Nutzen eines als Webdienst bereitgestellten Modells.
deploy_from_model

Stellen Sie einen Webdienst aus null oder mehr Model-Objekten bereit.

Diese Funktion ähnelt deploy, registriert jedoch nicht die Modelle. Verwenden Sie diese Funktion, wenn Sie bereits registrierte Modellobjekte haben. Dadurch wird im Prozess ein Image erstellt, das dem angegebenen Arbeitsbereich zugeordnet ist.

Der resultierende Webdienst ist ein Echtzeitendpunkt, der für Rückschlussanforderungen verwendet werden kann. Weitere Informationen finden Sie unter Nutzen eines als Webdienst bereitgestellten Modells.
deploy_local_from_model

Erstellen Sie einen LocalWebservice und stellen Sie ihn zum Testen bereit.

Docker muss installiert und konfiguriert sein.
deserialize

Konvertieren Sie ein JSON-Objekt einer Modellverwaltungsdienstantwort in ein Webdienstobjekt.

Ist nicht erfolgreich, wenn der bereitgestellte Arbeitsbereich nicht der Arbeitsbereich ist, in dem der Webdienst registriert ist.
get_keys

Rufen Sie die Authentifizierungsschlüssel für diesen Webdienst ab.
get_logs

Rufen Sie die Protokolle für diesen Webdienst ab.
get_token

Rufen Sie das Authentifizierungstoken für diesen Webdienst ab, das auf den aktuellen Benutzer beschränkt ist.
list

Listen Sie die Webdienste auf, die dem entsprechenden Workspace zugeordnet sind.

Die zurückgegebenen Ergebnisse können mithilfe von Parametern gefiltert werden.
regen_key

Generieren Sie einen der Schlüssel des Webdiensts erneut, entweder den primären Schlüssel („Primary“) oder den sekundären Schlüssel („Secondary“).

Eine WebserviceException wird ausgelöst, wenn key nicht angegeben ist oder nicht „Primary“ oder „Secondary“ lautet.
run

Rufen Sie diesen Webdienst mit der bereitgestellten Eingabe auf.

Abstrakte Methode, die von untergeordneten Klassen von Webservice implementiert wird.
serialize

Konvertieren Sie dieses Webdienstobjekt in ein serialisiertes JSON-Wörterbuch.

Verwenden Sie deserialize, um eine Konvertierung zurück in ein Webdienstobjekt durchzuführen.
update

Aktualisieren Sie die Webdienstparameter.

Dies ist eine abstrakte Methode, die von untergeordneten Klassen von Webservice implementiert wird. Mögliche zu aktualisierende Parameter variieren je nach untergeordnetem Webdiensttyp. Für Azure Container Instances-Webdienste beispielsweise finden Sie bestimmte Parameter unter update.
update_deployment_state

Aktualisieren des aktuellen Zustands des In-Memory-Objekts.

Führen Sie ein direktes Update der Eigenschaften des Objekts basierend auf dem aktuellen Zustand des entsprechenden Cloudobjekts durch. In erster Linie hilfreich zum manuellen Abruf des Erstellungsstatus.
wait_for_deployment

Fragen Sie die ausgeführte Webdienstbereitstellung automatisch ab.

Warten Sie, bis der Webdienst einen Endzustand erreicht. Löst eine WebserviceException aus, wenn er einen nicht erfolgreichen Endzustand erreicht oder das angegebene Timeout überschreitet.

check_for_existing_webservice

Überprüfen Sie, ob der Webdienst vorhanden ist.

static check_for_existing_webservice(workspace, name, overwrite=False, request_func=None, check_func=None)

Parameter

Name Beschreibung
workspace
Erforderlich
Workspace
name
Erforderlich
str
overwrite
bool
Standardwert: False
request_func
<xref:function>

Funktion zum Anfordern des Dienstes, um zu überprüfen, ob der Dienstname vorhanden ist

Standardwert: None
check_func
<xref:function>

Funktion zum Überprüfen des Antwortinhalts von request_func

Standardwert: None

Ausnahmen

Typ Beschreibung
WebserviceException

delete

Löschen Sie diesen Webdienst aus dem zugeordneten Arbeitsbereich.

Dieser Funktionsaufruf ist nicht asynchron. Der Aufruf wird ausgeführt, bis die Ressource gelöscht ist. Eine WebserviceException wird ausgelöst, wenn ein Problem beim Löschen des Modells aus dem Modellverwaltungsdienst besteht.

delete()

Ausnahmen

Typ Beschreibung
WebserviceException

deploy

Stellen Sie einen Webdienst aus null oder mehr Model-Objekten bereit.

Diese Funktion registriert alle bereitgestellten Modelldateien und erstellt im Prozess ein Image, das dem angegebenen Workspace zugeordnet ist. Verwenden Sie diese Funktion, wenn Sie über ein Verzeichnis mit bereitzustellenden Modellen verfügen, die noch nicht registriert wurden.

Der resultierende Webdienst ist ein Echtzeitendpunkt, der für Rückschlussanforderungen verwendet werden kann. Weitere Informationen finden Sie unter Nutzen eines als Webdienst bereitgestellten Modells.

static deploy(workspace, name, model_paths, image_config, deployment_config=None, deployment_target=None, overwrite=False)

Parameter

Name Beschreibung
workspace
Erforderlich
Workspace

Ein Arbeitsbereichsobjekt, dem der Webdienst zugeordnet werden soll.
name
Erforderlich
str

Der Name, der dem bereitgestellten Dienst zugewiesen werden soll. Muss für den Arbeitsbereich eindeutig sein, nur aus Kleinbuchstaben, Zahlen oder Bindestrichen bestehen, mit einem Buchstaben beginnen und zwischen 3 und 32 Zeichen lang sein.
model_paths
Erforderlich
list[str]

Eine Liste von Datenträgerpfaden zu Modelldateien oder Ordnern. Die Liste kann leer sein.
image_config
Erforderlich
ImageConfig

Ein ImageConfig-Objekt, das zum Bestimmen der erforderlichen Image-Eigenschaften verwendet wird.
deployment_config
WebserviceDeploymentConfiguration

Eine WebserviceDeploymentConfiguration, die zum Konfigurieren des Webdiensts verwendet wird. Wenn keine Konfiguration angegeben wird, wird basierend auf dem gewünschten Ziel ein leeres Konfigurationsobjekt verwendet.

Standardwert: None
deployment_target
ComputeTarget

Ein ComputeTarget, an dem der Webdienst bereitgestellt werden soll. Da Azure Container Instances nicht über ein zugeordnetes ComputeTarget verfügt, übernehmen Sie für diesen Parameter den Wert „None“, um den Webdienst in Azure Container Instances bereitzustellen.

Standardwert: None
overwrite
bool

Überschreiben Sie den vorhandenen Dienst, wenn bereits ein Dienst mit dem Namen vorhanden ist.

Standardwert: False

Gibt zurück

Typ Beschreibung
Webservice

Ein Webdienstobjekt, das dem bereitgestellten Webdienst entspricht.

Ausnahmen

Typ Beschreibung
WebserviceException

deploy_from_image

Stellen Sie einen Webdienst aus einem Image-Objekt bereit.

Verwenden Sie diese Funktion, wenn Sie bereits ein Image-Objekt für ein Modell erstellt haben.

Der resultierende Webdienst ist ein Echtzeitendpunkt, der für Rückschlussanforderungen verwendet werden kann. Weitere Informationen finden Sie unter Nutzen eines als Webdienst bereitgestellten Modells.

static deploy_from_image(workspace, name, image, deployment_config=None, deployment_target=None, overwrite=False)

Parameter

Name Beschreibung
workspace
Erforderlich
Workspace

Ein Arbeitsbereichsobjekt, dem der Webdienst zugeordnet werden soll.
name
Erforderlich
str

Der Name, der dem bereitgestellten Dienst zugewiesen werden soll. Muss für den Arbeitsbereich eindeutig sein, nur aus Kleinbuchstaben, Zahlen oder Bindestrichen bestehen, mit einem Buchstaben beginnen und zwischen 3 und 32 Zeichen lang sein.
image
Erforderlich
Image

Ein Image-Objekt, das bereitgestellt werden soll.
deployment_config
WebserviceDeploymentConfiguration

Eine WebserviceDeploymentConfiguration, die zum Konfigurieren des Webdiensts verwendet wird. Wenn keine Konfiguration angegeben wird, wird basierend auf dem gewünschten Ziel ein leeres Konfigurationsobjekt verwendet.

Standardwert: None
deployment_target
ComputeTarget

Ein ComputeTarget, an dem der Webdienst bereitgestellt werden soll. Da Azure Container Instances nicht über ein zugeordnetes ComputeTarget verfügt, übernehmen Sie für diesen Parameter den Wert „None“, um den Webdienst in Azure Container Instances bereitzustellen.

Standardwert: None
overwrite
bool

Überschreiben Sie den vorhandenen Dienst, wenn bereits ein Dienst mit dem Namen vorhanden ist.

Standardwert: False

Gibt zurück

Typ Beschreibung
Webservice

Ein Webdienstobjekt, das dem bereitgestellten Webdienst entspricht.

Ausnahmen

Typ Beschreibung
WebserviceException

deploy_from_model

Stellen Sie einen Webdienst aus null oder mehr Model-Objekten bereit.

Diese Funktion ähnelt deploy, registriert jedoch nicht die Modelle. Verwenden Sie diese Funktion, wenn Sie bereits registrierte Modellobjekte haben. Dadurch wird im Prozess ein Image erstellt, das dem angegebenen Arbeitsbereich zugeordnet ist.

Der resultierende Webdienst ist ein Echtzeitendpunkt, der für Rückschlussanforderungen verwendet werden kann. Weitere Informationen finden Sie unter Nutzen eines als Webdienst bereitgestellten Modells.

static deploy_from_model(workspace, name, models, image_config, deployment_config=None, deployment_target=None, overwrite=False)

Parameter

Name Beschreibung
workspace
Erforderlich
Workspace

Ein Arbeitsbereichsobjekt, dem der Webdienst zugeordnet werden soll.
name
Erforderlich
str

Der Name, der dem bereitgestellten Dienst zugewiesen werden soll. Muss für den Arbeitsbereich eindeutig sein, nur aus Kleinbuchstaben, Zahlen oder Bindestrichen bestehen, mit einem Buchstaben beginnen und zwischen 3 und 32 Zeichen lang sein.
models
Erforderlich
list[Model]

Eine Liste mit Modellobjekten. Die Liste kann leer sein.
image_config
Erforderlich
ImageConfig

Ein ImageConfig-Objekt, das zum Bestimmen der erforderlichen Image-Eigenschaften verwendet wird.
deployment_config
WebserviceDeploymentConfiguration

Eine WebserviceDeploymentConfiguration, die zum Konfigurieren des Webdiensts verwendet wird. Wenn keine Konfiguration angegeben wird, wird basierend auf dem gewünschten Ziel ein leeres Konfigurationsobjekt verwendet.

Standardwert: None
deployment_target
ComputeTarget

Ein ComputeTarget, an dem der Webdienst bereitgestellt werden soll. Da ACI nicht über ein zugeordnetes ComputeTarget verfügt, übernehmen Sie für diesen Parameter den Wert „None“, um den Webdienst in ACI bereitzustellen.

Standardwert: None
overwrite
bool

Überschreiben Sie den vorhandenen Dienst, wenn bereits ein Dienst mit dem Namen vorhanden ist.

Standardwert: False

Gibt zurück

Typ Beschreibung
Webservice

Ein Webdienstobjekt, das dem bereitgestellten Webdienst entspricht.

Ausnahmen

Typ Beschreibung
WebserviceException

deploy_local_from_model

Erstellen Sie einen LocalWebservice und stellen Sie ihn zum Testen bereit.

Docker muss installiert und konfiguriert sein.

static deploy_local_from_model(workspace, name, models, image_config, deployment_config=None, wait=False)

Parameter

Name Beschreibung
workspace
Erforderlich
Workspace

Ein Arbeitsbereichsobjekt, dem der Webdienst zugeordnet werden soll.
name
Erforderlich
str

Der Name, der dem bereitgestellten Dienst zugewiesen werden soll. Muss auf dem lokalen Computer eindeutig sein.
models
Erforderlich
list[Model]

Eine Liste mit Modellobjekten. Die Liste kann leer sein.
image_config
Erforderlich
ImageConfig

Ein ImageConfig-Objekt, das zum Bestimmen der erforderlichen Dienst-Image-Eigenschaften verwendet wird.
deployment_config
LocalWebserviceDeploymentConfiguration

Eine LocalWebserviceDeploymentConfiguration, die zum Konfigurieren des Webdiensts verwendet wird. Wenn keine Konfiguration angegeben wird, wird ein leeres Konfigurationsobjekt verwendet.

Standardwert: None
wait
bool

Gibt an, ob gewartet werden soll, bis der LocalWebservice-Docker-Container als fehlerfrei angezeigt wird. Löst eine Ausnahme aus, wenn der Container abstürzt. Die Standardeinstellung lautet „false“.

Standardwert: False

Gibt zurück

Typ Beschreibung
LocalWebservice

Ausnahmen

Typ Beschreibung
WebserviceException

deserialize

Konvertieren Sie ein JSON-Objekt einer Modellverwaltungsdienstantwort in ein Webdienstobjekt.

Ist nicht erfolgreich, wenn der bereitgestellte Arbeitsbereich nicht der Arbeitsbereich ist, in dem der Webdienst registriert ist.

deserialize(workspace, webservice_payload)

Parameter

Name Beschreibung
cls
Erforderlich

Gibt an, dass es sich um eine Klassenmethode handelt.
workspace
Erforderlich
Workspace

Das Arbeitsbereichsobjekt, unter dem der Webdienst registriert ist.
webservice_payload
Erforderlich
dict

Ein JSON-Objekt, das in ein Webdienstobjekt konvertiert werden soll.

Gibt zurück

Typ Beschreibung
Webservice

Die Webdienstdarstellung des bereitgestellten JSON-Objekts.

Ausnahmen

Typ Beschreibung
WebserviceException

get_keys

Rufen Sie die Authentifizierungsschlüssel für diesen Webdienst ab.

get_keys()

Gibt zurück

Typ Beschreibung
(str, str)

Die Authentifizierungsschlüssel für diesen Webdienst.

Ausnahmen

Typ Beschreibung
WebserviceException

get_logs

Rufen Sie die Protokolle für diesen Webdienst ab.

get_logs(num_lines=5000, init=False)

Parameter

Name Beschreibung
num_lines
int

Die maximale Anzahl der abzurufenden Protokollzeilen.

Standardwert: 5000
init
bool

Rufen Sie Protokolle für einen Init-Container ab

Standardwert: False

Gibt zurück

Typ Beschreibung
str

Die Protokolle für diesen Webdienst.

Ausnahmen

Typ Beschreibung
WebserviceException

get_token

Rufen Sie das Authentifizierungstoken für diesen Webdienst ab, das auf den aktuellen Benutzer beschränkt ist.

get_token()

Gibt zurück

Typ Beschreibung
str, datetime

Das Authentifizierungstoken für diesen Webdienst und nach welcher Zeit es aktualisiert werden soll.

Ausnahmen

Typ Beschreibung
WebserviceException

list

Listen Sie die Webdienste auf, die dem entsprechenden Workspace zugeordnet sind.

Die zurückgegebenen Ergebnisse können mithilfe von Parametern gefiltert werden.

static list(workspace, compute_type=None, image_name=None, image_id=None, model_name=None, model_id=None, tags=None, properties=None, image_digest=None)

Parameter

Name Beschreibung
workspace
Erforderlich
Workspace

Das Arbeitsbereichsobjekt, in dem die Webdienste aufgeführt werden.
compute_type
str

Filtern Sie, um nur bestimmte Webdiensttypen aufzulisten. Die Optionen lauten „ACI“, „AKS“.

Standardwert: None
image_name
str

Filtern Sie die Liste so, dass sie nur Webdienste enthält, die mit dem spezifischen Imagenamen bereitgestellt wurden.

Standardwert: None
image_id
str

Filtern Sie die Liste so, dass sie nur Webdienste enthält, die mit der spezifischen Image-ID bereitgestellt wurden.

Standardwert: None
model_name
str

Filtern Sie die Liste so, dass sie nur Webdienste enthält, die mit dem spezifischen Modellnamen bereitgestellt wurden.

Standardwert: None
model_id
str

Filtern Sie die Liste so, dass sie nur Webdienste enthält, die mit der spezifischen Modell-ID bereitgestellt wurden.

Standardwert: None
tags
list

Filtern Sie basierend auf der bereitgestellten Liste entweder nach „Schlüssel“ oder nach „[key, value]“. Ex. ['Schlüssel', ['Schlüssel2', 'Wert von Schlüssel2']]

Standardwert: None
properties
list

Filtern Sie basierend auf der bereitgestellten Liste entweder nach „Schlüssel“ oder nach „[key, value]“. Ex. ['Schlüssel', ['Schlüssel2', 'Wert von Schlüssel2']]

Standardwert: None
image_digest
str

Filtern Sie die Liste so, dass sie nur Webdienste enthält, die mit dem spezifischen Imagedigest bereitgestellt wurden.

Standardwert: None

Gibt zurück

Typ Beschreibung
list[Webservice]

Eine gefilterte Liste mit Webdiensten im bereitgestellten Arbeitsbereich.

Ausnahmen

Typ Beschreibung
WebserviceException

regen_key

Generieren Sie einen der Schlüssel des Webdiensts erneut, entweder den primären Schlüssel („Primary“) oder den sekundären Schlüssel („Secondary“).

Eine WebserviceException wird ausgelöst, wenn key nicht angegeben ist oder nicht „Primary“ oder „Secondary“ lautet.

regen_key(key, set_key=None)

Parameter

Name Beschreibung
key
Erforderlich
str

Der erneut zu generierende Schlüssel. Die Optionen lauten „Primary“ oder „Secondary“.
set_key
str

Ein vom Benutzer angegebener Wert, der eine manuelle Angabe des Schlüsselwerts ermöglicht

Standardwert: None

Ausnahmen

Typ Beschreibung
WebserviceException

run

Rufen Sie diesen Webdienst mit der bereitgestellten Eingabe auf.

Abstrakte Methode, die von untergeordneten Klassen von Webservice implementiert wird.

abstract run(input)

Parameter

Name Beschreibung
input
Erforderlich
<xref:varies>

Die Eingabedaten, mit denen der Webdienst aufgerufen werden soll. Dies sind die Daten, die Ihr Machine Learning-Modell als Eingabe zum Ausführen von Vorhersagen erwartet.

Gibt zurück

Typ Beschreibung
dict

Das Ergebnis des Aufrufs des Webdiensts. Damit werden Vorhersagen zurückgegeben, die von Ihrem Machine Learning-Modell ausgeführt werden.

Ausnahmen

Typ Beschreibung
WebserviceException

serialize

Konvertieren Sie dieses Webdienstobjekt in ein serialisiertes JSON-Wörterbuch.

Verwenden Sie deserialize, um eine Konvertierung zurück in ein Webdienstobjekt durchzuführen.

serialize()

Gibt zurück

Typ Beschreibung
dict

Die JSON-Darstellung dieses Webdiensts.

Ausnahmen

Typ Beschreibung
WebserviceException

update

Aktualisieren Sie die Webdienstparameter.

Dies ist eine abstrakte Methode, die von untergeordneten Klassen von Webservice implementiert wird. Mögliche zu aktualisierende Parameter variieren je nach untergeordnetem Webdiensttyp. Für Azure Container Instances-Webdienste beispielsweise finden Sie bestimmte Parameter unter update.

abstract update(*args)

Parameter

Name Beschreibung
args
Erforderlich
<xref:varies>

Zu aktualisierende Werte.

Ausnahmen

Typ Beschreibung
WebserviceException

update_deployment_state

Aktualisieren des aktuellen Zustands des In-Memory-Objekts.

Führen Sie ein direktes Update der Eigenschaften des Objekts basierend auf dem aktuellen Zustand des entsprechenden Cloudobjekts durch. In erster Linie hilfreich zum manuellen Abruf des Erstellungsstatus.

update_deployment_state()

Ausnahmen

Typ Beschreibung
WebserviceException

wait_for_deployment

Fragen Sie die ausgeführte Webdienstbereitstellung automatisch ab.

Warten Sie, bis der Webdienst einen Endzustand erreicht. Löst eine WebserviceException aus, wenn er einen nicht erfolgreichen Endzustand erreicht oder das angegebene Timeout überschreitet.

wait_for_deployment(show_output=False, timeout_sec=None)

Parameter

Name Beschreibung
show_output
bool

Gibt an, ob eine ausführlichere Ausgabe ausgegeben werden soll.

Standardwert: False
timeout_sec
float

Lösen Sie eine Ausnahme aus, wenn die Bereitstellung das angegebene Timeout überschreitet.

Standardwert: None

Ausnahmen

Typ Beschreibung
WebserviceException