AciWebservice Klasse
Stellt ein Machine Learning-Modell dar, das als Webdienst-Endpunkt in Azure Container Instances bereitgestellt wird.
Ein bereitgestellter Dienst wird aus einem Modell, einem Skript und zugehörigen Dateien erstellt. Der resultierende Webdienst ist ein HTTP-Endpunkt mit Lastenausgleich und einer REST-API. Sie können Daten an diese API senden und die vom Modell zurückgegebene Vorhersage empfangen.
Weitere Informationen finden Sie unter Bereitstellen eines Modells in Azure Container Instances.
Initialisieren Sie die 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
-
AciWebservice
Konstruktor
AciWebservice(workspace, name)
Parameter
- workspace
- Workspace
Das Arbeitsbereichsobjekt, das das abzurufende Webdienstobjekt enthält.
Hinweise
Das empfohlene Bereitstellungsmuster besteht darin, ein Bereitstellungskonfigurationsobjekt mit der deploy_configuration
-Methode zu erstellen und es dann wie unten dargestellt mit der deploy
-Methode der Model-Klasse zu verwenden.
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.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
Nutzen eines als Webdienst bereitgestellten Azure Machine Learning-Modells
Überwachen und Erfassen von Daten von ML-Webdienst-Endpunkten
Im Abschnitt Variablen werden Attribute einer lokalen Darstellung des Cloud-AciWebservice-Objekts aufgeführt. Diese Variablen sollten als schreibgeschützt betrachtet werden. Das Ändern ihrer Werte wird im entsprechenden Cloudobjekt nicht widergespiegelt.
Variablen
- enable_app_insights
- bool
Gibt an, ob die AppInsights-Protokollierung für den Webdienst aktiviert ist.
- cname
- str
Der CNAME für den Webdienst.
- container_resource_requirements
- ContainerResourceRequirements
Die Containerressourcenanforderungen für den Webdienst.
- encryption_properties
- EncryptionProperties
Die Verschlüsselungseigenschaften für den Webdienst.
- vnet_configuration
- VnetConfiguration
Die Eigenschaften des virtuellen Netzwerks für den Webdienst. Die Konfiguration muss vom Benutzer erstellt und bereitgestellt werden.
- azureml.core.webservice.AciWebservice.location
- str
Der Speicherort, an dem der Webdienst bereitgestellt wird.
- public_ip
- str
Die öffentliche IP-Adresse des Webdiensts.
- azureml.core.webservice.AciWebservice.scoring_uri
- str
Der Bewertungsendpunkt für den Webdienst.
- ssl_enabled
- bool
Gibt an, ob SSL für den Webdienst aktiviert ist
- public_fqdn
- str
Der öffentliche FQDN für den Webdienst
- environment
- Environment
Das Umgebungsobjekt, das zum Erstellen des Webdiensts verwendet wurde
Eine Liste der im Webdienst bereitgestellten Modelle
- azureml.core.webservice.AciWebservice.swagger_uri
- str
Der Swagger-Endpunkt für den Webdienst
Methoden
add_properties |
Fügen Sie dem Eigenschaftenwörterbuch dieses Webdiensts Schlüssel-Wert-Paare hinzu. |
add_tags |
Fügen Sie dem Tagwörterbuch dieses Webdiensts Schlüssel-Wert-Paare hinzu. |
deploy_configuration |
Erstellt ein Konfigurationsobjekt für die Bereitstellung eines AciWebservice. |
get_token |
Ruft das Authentifizierungstoken für diesen Webdienst ab, das auf den aktuellen Benutzer beschränkt ist. Hinweis Nicht implementiert. |
remove_tags |
Die angegebenen Schlüssel aus dem Wörterbuch der Tags dieses Webdiensts entfernen. |
run |
Ruft diesen Webdienst mit der bereitgestellten Eingabe auf. |
serialize |
Konvertiert diesen Webdienst in ein serialisiertes JSON-Schlüsselverzeichnis. |
update |
Den Webdienst mit den bereitgestellten Eigenschaften aktualisieren. Werte, die als „None“ belassen werden, bleiben in diesem Webdienst unverändert. |
add_properties
Fügen Sie dem Eigenschaftenwörterbuch dieses Webdiensts Schlüssel-Wert-Paare hinzu.
add_properties(properties)
Parameter
add_tags
Fügen Sie dem Tagwörterbuch dieses Webdiensts Schlüssel-Wert-Paare hinzu.
add_tags(tags)
Parameter
Ausnahmen
deploy_configuration
Erstellt ein Konfigurationsobjekt für die Bereitstellung eines AciWebservice.
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)
Parameter
- cpu_cores
- float
Die Anzahl von CPU-Kernen, die für diesen Webdienst zugeordnet werden sollen. Kann eine Dezimalzahl sein. Der Standardwert ist 0.1
- memory_gb
- float
Menge an Arbeitsspeicher (in GB), die für diesen Webdienst zugeordnet werden soll. Kann eine Dezimalzahl sein. Der Standardwert ist 0.5
Ein Wörterbuch der Schlüsselwerteigenschaften für diesen 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.
- location
- str
Die Azure-Region, in der dieser Webdienst bereitgestellt werden soll. Wenn keine Region angegeben ist, wird der Standort des Arbeitsbereichs verwendet. Weitere Details zu verfügbaren Regionen finden Sie unter Verfügbare Produkte nach Region.
- auth_enabled
- bool
Gibt an, ob die Authentifizierung für diesen Webdienst aktiviert werden soll. Der Standardwert lautet „False“.
- ssl_enabled
- bool
Gibt an, ob für diesen Webdienst SSL aktiviert werden soll. Der Standardwert lautet „False“.
- enable_app_insights
- bool
Gibt an, ob für diesen Webdienst AppInsights aktiviert werden soll. Der Standardwert lautet „False“.
- dns_name_label
- str
Die DNS-Namensbezeichnung für den Bewertungsendpunkt. Ist keine eindeutige DNS-Namensbezeichnung angegeben, wird eine für den Bewertungsendpunkt generiert.
- primary_key
- str
Ein primärer Authentifizierungsschlüssel, der für diesen Webdienst verwendet werden soll.
- secondary_key
- str
Ein sekundärer Authentifizierungsschlüssel, der für diesen Webdienst verwendet werden soll.
- collect_model_data
- bool
Gibt an, ob die Modelldatensammlung für den Webdienst aktiviert werden soll.
- cmk_vault_base_url
- str
Die Basis-URL des kundenseitig verwalteten Schlüsseltresors.
Gibt zurück
Ein Konfigurationsobjekt, das beim Bereitstellen eines Webdienstobjekts verwendet werden soll.
Rückgabetyp
Ausnahmen
get_token
Ruft das Authentifizierungstoken für diesen Webdienst ab, das auf den aktuellen Benutzer beschränkt ist.
Hinweis
Nicht implementiert.
get_token()
Gibt zurück
Das Authentifizierungstoken für diesen Webdienst und nach welcher Zeit es aktualisiert werden soll.
Rückgabetyp
Ausnahmen
remove_tags
Die angegebenen Schlüssel aus dem Wörterbuch der Tags dieses Webdiensts entfernen.
remove_tags(tags)
Parameter
run
Ruft diesen Webdienst mit der bereitgestellten Eingabe auf.
run(input_data)
Parameter
- input_data
- <xref:varies>
Die Eingabe zum Aufrufen des Webdiensts
Gibt zurück
Das Ergebnis des Aufrufs des Webdiensts.
Rückgabetyp
Ausnahmen
serialize
Konvertiert diesen Webdienst in ein serialisiertes JSON-Schlüsselverzeichnis.
serialize()
Gibt zurück
Die JSON-Darstellung dieses Webdienstobjekts.
Rückgabetyp
update
Den Webdienst mit den bereitgestellten Eigenschaften aktualisieren.
Werte, die als „None“ belassen werden, bleiben in diesem Webdienst unverändert.
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)
Parameter
Ein Wörterbuch der Schlüsselwerttags für diesen Webdienst. Ersetzt vorhandene Tags.
Ein Wörterbuch mit Schlüsselwerteigenschaften, die vorhandenen Eigenschaftenwörterbüchern hinzugefügt werden.
- auth_enabled
- bool
Aktiviert oder deaktiviert die Authentifizierung für diesen Webdienst.
- enable_app_insights
- bool
Gibt an, ob für diesen Webdienst AppInsights aktiviert werden soll.
Eine Liste der Modellobjekte, die in den aktualisierten Dienst gepackt werden sollen.
- inference_config
- InferenceConfig
Ein InferenceConfig-Objekt, das zum Bereitstellen der erforderlichen Eigenschaften der Modellimplementierung verwendet wird.
Rückgabetyp
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für