Workspace Klasse
Definiert eine Azure Machine Learning-Ressource zum Verwalten von Trainings- und Bereitstellungsartefakten.
Ein Arbeitsbereich ist eine grundlegende Ressource für das maschinelle Lernen in Azure Machine Learning. Sie verwenden einen Arbeitsbereich zum Experimentieren, Trainieren und Bereitstellen von Machine Learning-Modellen. Jeder Arbeitsbereich ist an ein Azure-Abonnement und eine Ressourcengruppe gebunden und verfügt über eine zugeordnete SKU.
Weitere Informationen zu Arbeitsbereichen finden Sie hier:
Klassenarbeitsbereichkonstruktor zum Laden eines vorhandenen Azure Machine Learning-Arbeitsbereichs.
- Vererbung
-
builtins.objectWorkspace
Konstruktor
Workspace(subscription_id, resource_group, workspace_name, auth=None, _location=None, _disable_service_check=False, _workspace_id=None, sku='basic', tags=None, _cloud='AzureCloud')
Parameter
Name | Beschreibung |
---|---|
subscription_id
Erforderlich
|
Die ID des Azure-Abonnements, das den Arbeitsbereich enthält. |
resource_group
Erforderlich
|
Die Ressourcengruppe mit dem Arbeitsbereich. |
workspace_name
Erforderlich
|
Der Name des vorhandenen Arbeitsbereichs. |
auth
|
Das Authentication-Objekt. Weitere Informationen finden Sie unter https://aka.ms/aml-notebook-auth. Bei None werden die Standardanmeldeinformationen für Azure CLI verwendet oder die API fragt nach Anmeldeinformationen. Standardwert: None
|
_location
|
Nur zur internen Verwendung. Standardwert: None
|
_disable_service_check
|
Nur zur internen Verwendung. Standardwert: False
|
_workspace_id
|
Nur zur internen Verwendung. Standardwert: None
|
sku
|
Der Parameter ist aus Gründen der Abwärtskompatibilität vorhanden und wird ignoriert. Standardwert: basic
|
_cloud
|
Nur interne Verwendung. Standardwert: AzureCloud
|
subscription_id
Erforderlich
|
Die ID des Azure-Abonnements, das den Arbeitsbereich enthält. |
resource_group
Erforderlich
|
Die Ressourcengruppe mit dem Arbeitsbereich. |
workspace_name
Erforderlich
|
Der Arbeitsbereichsname. Der Name muss zwischen 2 und 32 Zeichen lang sein. Das erste Zeichen des Namens muss alphanumerisch sein (Buchstabe oder Zahl), der Rest des Namens kann jedoch alphanumerische Zeichen, Bindestriche und Unterstriche enthalten. Leerzeichen sind nicht zulässig. |
auth
Erforderlich
|
Das Authentication-Objekt. Weitere Informationen finden Sie unter https://aka.ms/aml-notebook-auth. Bei None werden die Standardanmeldeinformationen für Azure CLI verwendet oder die API fragt nach Anmeldeinformationen. |
_location
Erforderlich
|
Nur zur internen Verwendung. |
_disable_service_check
Erforderlich
|
Nur zur internen Verwendung. |
_workspace_id
Erforderlich
|
Nur zur internen Verwendung. |
sku
Erforderlich
|
Der Parameter ist aus Gründen der Abwärtskompatibilität vorhanden und wird ignoriert. |
tags
|
Tags, die dem Arbeitsbereich zugeordnet werden sollen. Standardwert: None
|
_cloud
Erforderlich
|
Nur interne Verwendung. |
Hinweise
Das folgende Beispiel zeigt, wie Sie einen Arbeitsbereich erstellen.
from azureml.core import Workspace
ws = Workspace.create(name='myworkspace',
subscription_id='<azure-subscription-id>',
resource_group='myresourcegroup',
create_resource_group=True,
location='eastus2'
)
Legen Sie create_resource_group
auf „False“ fest, wenn Sie über eine vorhandene Azure-Ressourcengruppe verfügen, die Sie für den Arbeitsbereich verwenden möchten.
Wenn Sie den gleichen Arbeitsbereich in mehreren Umgebungen verwenden möchten, erstellen Sie eine JSON-Konfigurationsdatei. In der Konfigurationsdatei werden Ihr Abonnement, die Ressource und der Arbeitsbereichsname gespeichert, sodass der Arbeitsbereich ganz einfach geladen werden kann. Verwenden Sie zum Speichern der Konfiguration die write_config-Methode.
ws.write_config(path="./file-path", file_name="ws_config.json")
Ein Beispiel für die Konfigurationsdatei finden Sie unter Erstellen einer Konfigurationsdatei für den Arbeitsbereich.
Verwenden Sie die from_config-Methode, um den Arbeitsbereich aus der Konfigurationsdatei zu laden.
ws = Workspace.from_config()
ws.get_details()
Alternativ können Sie mit der get-Methode einen vorhandenen Arbeitsbereich laden, ohne Konfigurationsdateien zu verwenden.
ws = Workspace.get(name="myworkspace",
subscription_id='<azure-subscription-id>',
resource_group='myresourcegroup')
Bei den obigen Beispielen werden Sie möglicherweise in einem interaktiven Anmeldedialogfeld zur Eingabe von Anmeldeinformationen für die Azure-Authentifizierung aufgefordert. Weitere Anwendungsfälle, einschließlich Authentifizierung mithilfe der Azure CLI und Authentifizierung in automatisierten Workflows, finden Sie unter Authentifizierung in Azure Machine Learning.
Methoden
add_private_endpoint |
Hinzufügen eines privaten Endpunkts zum Arbeitsbereich. |
create |
Erstellen Sie einen neuen Azure Machine Learning-Arbeitsbereich. Löst eine Ausnahme aus, wenn der Arbeitsbereich bereits vorhanden oder eine der Arbeitsbereichsanforderungen nicht erfüllt ist. |
delete |
Löschen Sie den Azure Machine Learning-Arbeitsbereich und die zugeordneten Ressourcen. |
delete_connection |
Löschen Sie eine Verbindung des Arbeitsbereichs. |
delete_private_endpoint_connection |
Löschen der Verbindung mit privatem Endpunkt für den Arbeitsbereich. |
diagnose_workspace |
Diagnostizieren von Problemen beim Einrichten des Arbeitsbereichs. |
from_config |
Geben Sie ein Arbeitsbereichsobjekts aus einem vorhandenen Azure Machine Learning-Arbeitsbereich zurück. Liest die Arbeitsbereichskonfiguration aus einer Datei. Löst eine Ausnahme aus, wenn die Konfigurationsdatei nicht gefunden wird. Diese Methode ermöglicht die einfache Wiederverwendung des gleichen Arbeitsbereichs in mehreren Python-Notebooks oder -Projekten. Benutzer können die Azure Resource Manager (ARM)-Eigenschaften des Arbeitsbereichs mithilfe der write_config-Methode speichern und den gleichen Arbeitsbereich mit dieser Methode in verschiedene Python-Notebooks oder -Projekte laden, ohne die ARM-Eigenschaften des Arbeitsbereichs erneut eingeben zu müssen. |
get |
Geben Sie ein Arbeitsbereichsobjekt für einen vorhandenen Azure Machine Learning-Arbeitsbereich zurück. Löst eine Ausnahme aus, wenn der Arbeitsbereich nicht vorhanden ist oder die Pflichtfelder keinen Arbeitsbereich eindeutig identifizieren. |
get_connection |
Abrufen einer Verbindung des Arbeitsbereichs. |
get_default_compute_target |
Rufen Sie das Standardcomputeziel für den Arbeitsbereich ab. |
get_default_datastore |
Abrufen des Standarddatenspeichers für den Arbeitsbereich. |
get_default_keyvault |
Abrufen des Standardschlüsseltresor-Objekts für den Arbeitsbereich. |
get_details |
Geben Sie die Details des Arbeitsbereichs zurück. |
get_mlflow_tracking_uri |
Rufen Sie den MLflow-Nachverfolgungs-URI für den Arbeitsbereich ab. MLflow (https://mlflow.org/) ist eine Open-Source-Plattform zum Nachverfolgen von Machine Learning-Experimenten und Verwalten von Modellen. Sie können MLflow-Protokollierungs-APIs mit Azure Machine Learning verwenden, damit Metriken, Modelle und Artefakte in Ihrem Azure Machine Learning-Arbeitsbereich protokolliert werden. |
get_run |
Geben Sie die Ausführung mit der angegebenen „run_id“ im Arbeitsbereich zurück. |
list |
Listen Sie alle Arbeitsbereiche auf, zu denen der Benutzer innerhalb des Abonnements Zugriff hat. Die Liste der Arbeitsbereiche kann nach der Ressourcengruppe gefiltert werden. |
list_connections |
Listen Sie die Verbindungen in diesem Arbeitsbereich auf. |
list_keys |
Listen Sie die Schlüssel für den aktuellen Arbeitsbereich auf. |
set_connection |
Fügen Sie eine Verbindung im Arbeitsbereich hinzu oder aktualisieren Sie diese. |
set_default_datastore |
Legen Sie den Standarddatenspeicher für den Arbeitsbereich fest. |
setup |
Erstellen eines neuen Arbeitsbereichs oder Abrufen eines vorhandenen Arbeitsbereichs. |
sync_keys |
Löst eine sofortige Schlüsselsynchronisierung im Arbeitsbereich aus. Wenn Schlüssel für Ressourcen im Arbeitsbereich geändert werden, kann es etwa eine Stunde dauern, bis diese automatisch aktualisiert werden. Mit dieser Funktion können Schlüssel auf Anforderung aktualisiert werden. Sie kann z. B. verwendet werden, wenn nach dem erneuten Generieren von Speicherschlüsseln der sofortige Zugriff auf den Speicher erforderlich ist. |
update |
Aktualisieren von Anzeigename, Beschreibung, Tags, Computename für die Imageerstellung und anderen Einstellungen eines Arbeitsbereichs. |
update_dependencies |
Aktualisieren der vorhandenen zugeordneten Ressourcen für den Arbeitsbereich. Diese Methode kann in folgenden Fällen verwendet werden. a) Wenn ein Benutzer versehentlich eine vorhandene zugeordnete Ressource löscht und diese mit einer neuen Ressource aktualisieren möchte, ohne den gesamten Arbeitsbereich neu erstellen zu müssen. b) Wenn ein Benutzer über eine vorhandene zugeordnete Ressource verfügt und die Ressource ersetzen möchte, die dem Arbeitsbereich aktuell zugeordnet ist. c) Wenn noch keine zugeordnete Ressource erstellt wurde und eine bereits vorhandene Ressource verwendet werden soll (gilt nur für die Containerregistrierung). |
write_config |
Schreiben Sie die Azure Resource Manager (ARM)-Eigenschaften des Arbeitsbereichs in eine Konfigurationsdatei. Die ARM-Eigenschaften des Arbeitsbereichs können später mit der from_config-Methode geladen werden. Der Standardwert von Diese Methode ermöglicht die einfache Wiederverwendung des gleichen Arbeitsbereichs in mehreren Python-Notebooks oder -Projekten. Benutzer können die ARM-Eigenschaften des Arbeitsbereichs mithilfe dieser Funktion speichern und den gleichen Arbeitsbereich mit from_config in verschiedene Python-Notebooks oder -Projekte laden, ohne die ARM-Eigenschaften des Arbeitsbereichs erneut eingeben zu müssen. |
add_private_endpoint
Hinzufügen eines privaten Endpunkts zum Arbeitsbereich.
add_private_endpoint(private_endpoint_config, private_endpoint_auto_approval=True, location=None, show_output=True, tags=None)
Parameter
Name | Beschreibung |
---|---|
private_endpoint_config
Erforderlich
|
Die Konfiguration des privaten Endpunkts zum Erstellen eines privaten Endpunkts für den Arbeitsbereich. |
private_endpoint_auto_approval
|
Ein boolesches Flag, das angibt, ob die Erstellung des privaten Endpunkts automatisch oder manuell über das Azure Private Link Center genehmigt werden soll. Im Fall einer manuellen Genehmigung können Benutzer die ausstehende Anforderung im Private Link-Portal anzeigen, um sie zu genehmigen/abzulehnen. Standardwert: True
|
location
|
Der Speicherort des privaten Endpunkts. Der Standardwert ist der Speicherort des Arbeitsbereichs Standardwert: None
|
show_output
|
Ein Flag zum Anzeigen des Fortschritts der Arbeitsbereichserstellung Standardwert: True
|
tags
|
Tags, die dem Arbeitsbereich zugeordnet werden sollen. Standardwert: None
|
Gibt zurück
Typ | Beschreibung |
---|---|
Das erstellte PrivateEndPoint-Objekt. |
create
Erstellen Sie einen neuen Azure Machine Learning-Arbeitsbereich.
Löst eine Ausnahme aus, wenn der Arbeitsbereich bereits vorhanden oder eine der Arbeitsbereichsanforderungen nicht erfüllt ist.
static create(name, auth=None, subscription_id=None, resource_group=None, location=None, create_resource_group=True, sku='basic', tags=None, friendly_name=None, storage_account=None, key_vault=None, app_insights=None, container_registry=None, adb_workspace=None, primary_user_assigned_identity=None, cmk_keyvault=None, resource_cmk_uri=None, hbi_workspace=False, default_cpu_compute_target=None, default_gpu_compute_target=None, private_endpoint_config=None, private_endpoint_auto_approval=True, exist_ok=False, show_output=True, user_assigned_identity_for_cmk_encryption=None, system_datastores_auth_mode='accessKey', v1_legacy_mode=None)
Parameter
Name | Beschreibung |
---|---|
name
Erforderlich
|
Der Name des neuen Arbeitsbereichs. Der Name muss zwischen 2 und 32 Zeichen lang sein. Das erste Zeichen des Namens muss alphanumerisch sein (Buchstabe oder Zahl), der Rest des Namens kann jedoch alphanumerische Zeichen, Bindestriche und Unterstriche enthalten. Leerzeichen sind nicht zulässig. |
auth
|
Das Authentication-Objekt. Weitere Informationen finden Sie unter https://aka.ms/aml-notebook-auth. Bei None werden die Standardanmeldeinformationen für Azure CLI verwendet oder die API fragt nach Anmeldeinformationen. Standardwert: None
|
subscription_id
|
Die Abonnement-ID des enthaltenden Abonnements für den neuen Arbeitsbereich. Der Parameter ist erforderlich, wenn der Benutzer Zugriff auf mehrere Abonnements hat. Standardwert: None
|
resource_group
|
Die Azure-Ressourcengruppe, die den Arbeitsbereich enthält. Der Standardwert des Parameters ist eine Abwandlung des Arbeitsbereichsnamens. Standardwert: None
|
location
|
Standort des Arbeitsbereichs. Der Standardwert des Parameters ist der Standort der Ressourcengruppe. Der Standort muss eine unterstützte Region für Azure Machine Learning sein. Standardwert: None
|
create_resource_group
|
Gibt an, ob die Ressourcengruppe erstellt werden soll, wenn sie nicht vorhanden ist. Standardwert: True
|
sku
|
Der Parameter ist aus Gründen der Abwärtskompatibilität vorhanden und wird ignoriert. Standardwert: basic
|
tags
|
Tags, die dem Arbeitsbereich zugeordnet werden sollen. Standardwert: None
|
friendly_name
|
Ein optionaler Anzeigename für den Arbeitsbereich, der auf der Benutzeroberfläche angezeigt werden kann. Standardwert: None
|
storage_account
|
Ein vorhandenes Speicherkonto im Azure-Ressourcen-ID-Format. Der Speicher wird vom Arbeitsbereich verwendet, um Ausführungsausgaben, Code, Protokolle usw. zu speichern. Bei None wird ein neues Speicherkonto erstellt. Standardwert: None
|
key_vault
|
Ein vorhandener Schlüsseltresor im Azure-Ressourcen-ID-Format. Weitere Informationen zum Azure-Ressourcen-ID-Format finden Sie unten im Beispielcode. Der Schlüsseltresor wird vom Arbeitsbereich verwendet, um Anmeldeinformationen zu speichern, die dem Arbeitsbereich von den Benutzern hinzugefügt werden. Bei None wird ein neuer Schlüsseltresor erstellt. Standardwert: None
|
app_insights
|
Eine vorhandene Application Insights-Instanz im Azure-Ressourcen-ID-Format. Weitere Informationen zum Azure-Ressourcen-ID-Format finden Sie unten im Beispielcode. Die Application Insights-Instanz wird vom Arbeitsbereich verwendet, um Webdienstereignisse zu protokollieren. Bei None wird eine neue Application Insights-Instanz erstellt. Standardwert: None
|
container_registry
|
Eine vorhandene Containerregistrierung im Azure-Ressourcen-ID-Format (weitere Informationen zum Azure-Ressourcen-ID-Format finden Sie unten im Beispielcode). Die Containerregistrierung wird vom Arbeitsbereich verwendet, um Experimente und Webdienstimages zu pullen und zu pushen. Bei None wird nicht im Rahmen der Erstellung des Arbeitsbereichs, sondern nur bei Bedarf eine neue Containerregistrierung erstellt. Standardwert: None
|
adb_workspace
|
Ein vorhandener adb-Arbeitsbereich im Azure-Ressourcen-ID-Format (weitere Informationen zum Azure-Ressourcen-ID-Format finden Sie unten im Beispielcode). Der Adb-Arbeitsbereich wird zum Verknüpfen mit dem Arbeitsbereich verwendet. Bei „None“ wird der Arbeitsbereich nicht verknüpft. Standardwert: None
|
primary_user_assigned_identity
|
Die Ressourcen-ID der benutzerseitig zugewiesenen Identität, die zum Darstellen des Arbeitsbereichs verwendet wird. Standardwert: None
|
cmk_keyvault
|
Der Schlüsseltresor, der den kundenseitig verwalteten Schlüssel enthält, im Azure-Ressourcen-ID-Format:
Standardwert: None
|
resource_cmk_uri
|
Der Schlüssel-URI des kundenseitig verwalteten Schlüssels zum Verschlüsseln ruhender Daten.
Das URI-Format ist Standardwert: None
|
hbi_workspace
|
Gibt an, ob der Arbeitsbereich Daten mit hohen geschäftlichen Auswirkungen (High Business Impact, HBI) enthält, d.h. vertrauliche Geschäftsinformationen. Dieses Flag kann nur während der Erstellung des Arbeitsbereichs festgelegt werden. Nach dem Erstellen des Arbeitsbereichs kann der Wert nicht mehr geändert werden. Der Standardwert ist False. Wenn True festgelegt ist, werden weitere Verschlüsselungsschritte ausgeführt, und abhängig von der SDK-Komponente werden Informationen in intern erfassten Telemetriedaten unkenntlich gemacht. Weitere Informationen finden Sie unter Datenverschlüsselung. Wenn dieses Flag auf True gesetzt ist, ist eine mögliche Auswirkung mehr Schwierigkeiten bei der Problembehandlung. Dies kann passieren, weil einige Telemetriedaten nicht an Microsoft gesendet werden und weniger Einblick in Erfolgsraten oder Problemtypen besteht und daher möglicherweise nicht so proaktiv reagieren kann, wenn dieses Flag auf True gesetzt ist. Es wird empfohlen, für dieses Flag den Standardwert False zu verwenden, sofern nicht unbedingt True festgelegt werden muss. Standardwert: False
|
default_cpu_compute_target
|
(VERALTET) Eine Konfiguration, die zum Erstellen einer CPU-Compute-Ressource verwendet wird. Der Standardwert des Parameters ist {min_nodes=0, max_nodes=2, vm_size="STANDARD_DS2_V2", vm_priority="dedicated"}. Bei None wird keine Compute-Ressource erstellt. Standardwert: None
|
default_gpu_compute_target
|
(VERALTET) Eine Konfiguration, die zum Erstellen einer GPU-Compute-Ressource verwendet wird. Der Standardwert des Parameters ist {min_nodes=0, max_nodes=2, vm_size="STANDARD_NC6", vm_priority="dedicated"}. Bei None wird keine Compute-Ressource erstellt. Standardwert: None
|
private_endpoint_config
|
Die Konfiguration des privaten Endpunkts zum Erstellen eines privaten Endpunkts für den Azure ML-Arbeitsbereich. Standardwert: None
|
private_endpoint_auto_approval
|
Ein boolesches Flag, das angibt, ob die Erstellung des privaten Endpunkts automatisch oder manuell über das Azure Private Link Center genehmigt werden soll. Im Fall einer manuellen Genehmigung können Benutzer die ausstehende Anforderung im Private Link-Portal anzeigen, um sie zu genehmigen/abzulehnen. Standardwert: True
|
exist_ok
|
Gibt an, ob diese Methode erfolgreich ist, wenn der Arbeitsbereich bereits vorhanden ist. Bei False tritt bei der Ausführung dieser Methode ein Fehler auf, wenn der Arbeitsbereich vorhanden ist. Bei True gibt diese Methode den vorhandenen Arbeitsbereich zurück. Standardwert: False
|
show_output
|
Gibt an, ob diese Methode den inkrementellen Status ausgibt. Standardwert: True
|
user_assigned_identity_for_cmk_encryption
|
Die Ressourcen-ID der benutzerseitig zugewiesenen Identität, die für den Zugriff auf den kundenseitig verwalteten Schlüssel verwendet werden muss. Standardwert: None
|
system_datastores_auth_mode
|
Bestimmt, ob Anmeldeinformationen für die Systemdatenspeicher „workspaceblobstore“ und „workspacefilestore“ des Arbeitsbereichs verwendet werden. Der Standardwert ist „accessKey“. In diesem Fall erstellt der Arbeitsbereich die Systemdatenspeicher mit Anmeldeinformationen. Wenn „identity“ festgelegt ist, erstellt der Arbeitsbereich die Systemdatenspeicher ohne Anmeldeinformationen. Standardwert: accessKey
|
v1_legacy_mode
|
Verhindern der Verwendung des v2-API-Diensts in öffentlichen Azure-Resource Manager Standardwert: None
|
Gibt zurück
Typ | Beschreibung |
---|---|
Das Arbeitsbereichsobjekt. |
Ausnahmen
Typ | Beschreibung |
---|---|
Wird bei Problemen beim Erstellen des Arbeitsbereichs ausgelöst. |
Hinweise
Dieses erste Beispiel erfordert nur minimale Angaben, und alle abhängigen Ressourcen sowie die Ressourcengruppe werden automatisch erstellt.
from azureml.core import Workspace
ws = Workspace.create(name='myworkspace',
subscription_id='<azure-subscription-id>',
resource_group='myresourcegroup',
create_resource_group=True,
location='eastus2')
Das folgende Beispiel zeigt, wie Sie vorhandene Azure-Ressourcen mithilfe des Azure-Ressourcen-ID-Formats wiederverwenden. Die spezifischen Azure-Ressourcen-IDs können über das Azure-Portal oder das SDK abgerufen werden. Dieses Beispiel setzt voraus, dass die Ressourcengruppe, das Speicherkonto, der Schlüsseltresor, eine App Insights-Instanz und die Containerregistrierung bereits vorhanden sind.
import os
from azureml.core import Workspace
from azureml.core.authentication import ServicePrincipalAuthentication
service_principal_password = os.environ.get("AZUREML_PASSWORD")
service_principal_auth = ServicePrincipalAuthentication(
tenant_id="<tenant-id>",
username="<application-id>",
password=service_principal_password)
ws = Workspace.create(name='myworkspace',
auth=service_principal_auth,
subscription_id='<azure-subscription-id>',
resource_group='myresourcegroup',
create_resource_group=False,
location='eastus2',
friendly_name='My workspace',
storage_account='subscriptions/<azure-subscription-id>/resourcegroups/myresourcegroup/providers/microsoft.storage/storageaccounts/mystorageaccount',
key_vault='subscriptions/<azure-subscription-id>/resourcegroups/myresourcegroup/providers/microsoft.keyvault/vaults/mykeyvault',
app_insights='subscriptions/<azure-subscription-id>/resourcegroups/myresourcegroup/providers/microsoft.insights/components/myappinsights',
container_registry='subscriptions/<azure-subscription-id>/resourcegroups/myresourcegroup/providers/microsoft.containerregistry/registries/mycontainerregistry',
exist_ok=False)
delete
Löschen Sie den Azure Machine Learning-Arbeitsbereich und die zugeordneten Ressourcen.
delete(delete_dependent_resources=False, no_wait=False)
Parameter
Name | Beschreibung |
---|---|
delete_dependent_resources
|
Gibt an, ob dem Arbeitsbereich zugeordnete Ressourcen gelöscht werden sollen, d.h. Containerregistrierung, Speicherkonto, Schlüsseltresor und Application Insights-Instanz. Die Standardeinstellung lautet „false“. Legen Sie True fest, um diese Ressourcen zu löschen. Standardwert: False
|
no_wait
|
Gibt an, ob auf den Abschluss des Löschvorgangs für den Arbeitsbereich gewartet werden soll. Standardwert: False
|
Gibt zurück
Typ | Beschreibung |
---|---|
Bei erfolgreicher Ausführung wird nichts zurückgegeben. Andernfalls wird ein Fehler ausgelöst. |
delete_connection
Löschen Sie eine Verbindung des Arbeitsbereichs.
delete_connection(name)
Parameter
Name | Beschreibung |
---|---|
name
Erforderlich
|
Der eindeutige Name der Verbindung im Arbeitsbereich |
delete_private_endpoint_connection
Löschen der Verbindung mit privatem Endpunkt für den Arbeitsbereich.
delete_private_endpoint_connection(private_endpoint_connection_name)
Parameter
Name | Beschreibung |
---|---|
private_endpoint_connection_name
Erforderlich
|
Der eindeutige Name der Verbindung mit privatem Endpunkt im Arbeitsbereich |
diagnose_workspace
Diagnostizieren von Problemen beim Einrichten des Arbeitsbereichs.
diagnose_workspace(diagnose_parameters)
Parameter
Name | Beschreibung |
---|---|
diagnose_parameters
Erforderlich
|
<xref:_restclient.models.DiagnoseWorkspaceParameters>
Der Parameter zum Diagnostizieren der Arbeitsbereichsintegrität. |
Gibt zurück
Typ | Beschreibung |
---|---|
<xref:msrestazure.azure_operation.AzureOperationPoller>[<xref:_restclient.models.DiagnoseResponseResult>]
|
Eine AzureOperationPoller-Instanz, die DiagnoseResponseResult zurückgibt. |
from_config
Geben Sie ein Arbeitsbereichsobjekts aus einem vorhandenen Azure Machine Learning-Arbeitsbereich zurück.
Liest die Arbeitsbereichskonfiguration aus einer Datei. Löst eine Ausnahme aus, wenn die Konfigurationsdatei nicht gefunden wird.
Diese Methode ermöglicht die einfache Wiederverwendung des gleichen Arbeitsbereichs in mehreren Python-Notebooks oder -Projekten. Benutzer können die Azure Resource Manager (ARM)-Eigenschaften des Arbeitsbereichs mithilfe der write_config-Methode speichern und den gleichen Arbeitsbereich mit dieser Methode in verschiedene Python-Notebooks oder -Projekte laden, ohne die ARM-Eigenschaften des Arbeitsbereichs erneut eingeben zu müssen.
static from_config(path=None, auth=None, _logger=None, _file_name=None)
Parameter
Name | Beschreibung |
---|---|
path
|
Der Pfad zur Konfigurationsdatei oder zum Startverzeichnis, in dem gesucht werden soll. Beim Standardwert des Parameters beginnt die Suche im aktuellen Verzeichnis. Standardwert: None
|
auth
|
Das Authentication-Objekt. Weitere Informationen finden Sie unter https://aka.ms/aml-notebook-auth. Bei None werden die Standardanmeldeinformationen für Azure CLI verwendet oder die API fragt nach Anmeldeinformationen. Standardwert: None
|
_logger
|
Ermöglicht die Außerkraftsetzung der Standardprotokollierung. Standardwert: None
|
_file_name
|
Ermöglicht das Überschreiben des Konfigurationsdateinamens, nach dem gesucht wird, wenn der Pfad ein Verzeichnispfad ist. Standardwert: None
|
Gibt zurück
Typ | Beschreibung |
---|---|
Das Arbeitsbereichsobjekt für einen vorhandenen Azure ML-Arbeitsbereich. |
get
Geben Sie ein Arbeitsbereichsobjekt für einen vorhandenen Azure Machine Learning-Arbeitsbereich zurück.
Löst eine Ausnahme aus, wenn der Arbeitsbereich nicht vorhanden ist oder die Pflichtfelder keinen Arbeitsbereich eindeutig identifizieren.
static get(name, auth=None, subscription_id=None, resource_group=None, location=None, cloud='AzureCloud', id=None)
Parameter
Name | Beschreibung |
---|---|
name
Erforderlich
|
Der Name des abzurufenden Arbeitsbereichs. |
auth
|
Das Authentication-Objekt. Weitere Informationen finden Sie unter https://aka.ms/aml-notebook-auth. Bei „None“ werden die Standardanmeldeinformationen für die Azure-Befehlszeilenschnittstelle (Azure CLI) verwendet, oder die API fordert zur Eingabe von Anmeldeinformationen auf. Standardwert: None
|
subscription_id
|
Die zu verwendende Abonnement-ID. Der Parameter ist erforderlich, wenn der Benutzer Zugriff auf mehrere Abonnements hat. Standardwert: None
|
resource_group
|
Die zu verwendende Ressourcengruppe. Bei „None“ durchsucht die Methode alle Ressourcengruppen im Abonnement. Standardwert: None
|
location
|
Der Speicherort des Arbeitsbereichs. Standardwert: None
|
cloud
|
Der Name der Zielcloud. Die möglichen Werte sind „AzureCloud“, „AzureChinaCloud“ und „AzureUSGovernment“. Wenn keine Cloud angegeben wird, wird „AzureCloud“ verwendet. Standardwert: AzureCloud
|
id
|
Die ID des Arbeitsbereichs. Standardwert: None
|
Gibt zurück
Typ | Beschreibung |
---|---|
Das Workspace-Objekt. |
get_connection
Abrufen einer Verbindung des Arbeitsbereichs.
get_connection(name)
Parameter
Name | Beschreibung |
---|---|
name
Erforderlich
|
Der eindeutige Name der Verbindung im Arbeitsbereich |
get_default_compute_target
Rufen Sie das Standardcomputeziel für den Arbeitsbereich ab.
get_default_compute_target(type)
Parameter
Name | Beschreibung |
---|---|
type
Erforderlich
|
Der Computetyp. Die möglichen Werte sind ‚CPU‘ und ‚GPU‘. |
Gibt zurück
Typ | Beschreibung |
---|---|
Das Standardcomputeziel für den angegebenen Computetyp. |
get_default_datastore
Abrufen des Standarddatenspeichers für den Arbeitsbereich.
get_default_datastore()
Gibt zurück
Typ | Beschreibung |
---|---|
Der Standarddatenspeicher. |
get_default_keyvault
Abrufen des Standardschlüsseltresor-Objekts für den Arbeitsbereich.
get_default_keyvault()
Gibt zurück
Typ | Beschreibung |
---|---|
Das KeyVault-Objekt, das dem Arbeitsbereich zugeordnet ist. |
get_details
Geben Sie die Details des Arbeitsbereichs zurück.
get_details()
Gibt zurück
Typ | Beschreibung |
---|---|
Details zum Arbeitsbereich im Wörterbuchformat. |
Hinweise
Das zurückgegebene Wörterbuch enthält die folgenden Schlüssel-Wert-Paare.
id: Der URI, der auf diese Arbeitsbereichsressource verweist, die ID des enthaltenden Abonnements, die Ressourcengruppe und der Arbeitsbereichsname.
name: Der Name dieses Arbeitsbereichs.
location: Die Arbeitsbereichsregion.
type: Ein URI im Format „{providerName}/workspaces“.
tags: Wird derzeit nicht verwendet.
workspaceid: Die ID dieses Arbeitsbereichs.
description: Wird derzeit nicht verwendet.
friendlyName: Ein Anzeigename für den Arbeitsbereich, der auf der Benutzeroberfläche angezeigt wird.
creationTime: Der Zeitpunkt der Erstellung dieses Arbeitsbereichs im ISO8601-Format.
containerRegistry: Die Containerregistrierung des Arbeitsbereichs, die zum Pullen und Pushen von Experimenten und Webdienstimages verwendet wird.
keyVault: Der Schlüsseltresor des Arbeitsbereichs, der zum Speichern von Anmeldeinformationen verwendet wird, die dem Arbeitsbereich von den Benutzern hinzugefügt werden.
applicationInsights: Die Application Insights-Instanz wird vom Arbeitsbereich verwendet, um Webdienstereignisse zu protokollieren.
identityPrincipalId:
identityTenantId
identityType
storageAccount: Der Speicher wird vom Arbeitsbereich verwendet, um Ausführungsausgaben, Code, Protokolle usw. zu speichern.
sku: Die Arbeitsbereichs-SKU (wird auch als Edition bezeichnet). Der Parameter ist aus Gründen der Abwärtskompatibilität vorhanden und wird ignoriert.
resourceCmkUri: Der Schlüssel-URI des kundenseitig verwalteten Schlüssels zum Verschlüsseln ruhender Daten. Anweisungen zum Erstellen eines Schlüssels und Abrufen des URI finden Sie unter https://docs.microsoft.com/en-us/azure-stack/user/azure-stack-key-vault-manage-portal?view=azs-1910.
hbiWorkspace: Gibt an, ob die Kundendaten hohe geschäftliche Auswirkungen haben.
imageBuildCompute: Das Computeziel für die Imageerstellung.
systemDatastoresAuthMode: Bestimmt, ob Anmeldeinformationen für die Systemdatenspeicher „workspaceblobstore“ und „workspacefilestore“ des Arbeitsbereichs verwendet werden. Der Standardwert ist „accessKey“. In diesem Fall erstellt der Arbeitsbereich die Systemdatenspeicher mit Anmeldeinformationen. Wenn „identity“ festgelegt ist, erstellt der Arbeitsbereich die Systemdatenspeicher ohne Anmeldeinformationen.
Weitere Informationen zu diesen Schlüssel-Wert-Paaren finden Sie unter create.
get_mlflow_tracking_uri
Rufen Sie den MLflow-Nachverfolgungs-URI für den Arbeitsbereich ab.
MLflow (https://mlflow.org/) ist eine Open-Source-Plattform zum Nachverfolgen von Machine Learning-Experimenten und Verwalten von Modellen. Sie können MLflow-Protokollierungs-APIs mit Azure Machine Learning verwenden, damit Metriken, Modelle und Artefakte in Ihrem Azure Machine Learning-Arbeitsbereich protokolliert werden.
get_mlflow_tracking_uri(_with_auth=False)
Parameter
Name | Beschreibung |
---|---|
_with_auth
|
(VERALTET) Hinzufügen von Authentifizierungsinformationen zum Nachverfolgungs-URI. Standardwert: False
|
Gibt zurück
Typ | Beschreibung |
---|---|
Der MLflow-kompatible Nachverfolgungs-URI. |
Hinweise
Verwenden Sie das folgende Beispiel, um die MLflow-Nachverfolgung zum Senden von Daten an den Azure ML-Arbeitsbereich zu konfigurieren:
import mlflow
from azureml.core import Workspace
workspace = Workspace.from_config()
mlflow.set_tracking_uri(workspace.get_mlflow_tracking_uri())
get_run
Geben Sie die Ausführung mit der angegebenen „run_id“ im Arbeitsbereich zurück.
get_run(run_id)
Parameter
Name | Beschreibung |
---|---|
run_id
Erforderlich
|
Die Ausführungs-ID. |
Gibt zurück
Typ | Beschreibung |
---|---|
Die übermittelte Ausführung. |
list
Listen Sie alle Arbeitsbereiche auf, zu denen der Benutzer innerhalb des Abonnements Zugriff hat.
Die Liste der Arbeitsbereiche kann nach der Ressourcengruppe gefiltert werden.
static list(subscription_id, auth=None, resource_group=None)
Parameter
Name | Beschreibung |
---|---|
subscription_id
Erforderlich
|
Die Abonnement-ID, für die Arbeitsbereiche aufgelistet werden sollen. |
auth
|
Das Authentication-Objekt. Weitere Informationen finden Sie unter https://aka.ms/aml-notebook-auth. Bei „None“ werden die Standardanmeldeinformationen für die Azure-Befehlszeilenschnittstelle (Azure CLI) verwendet, oder die API fordert zur Eingabe von Anmeldeinformationen auf. Standardwert: None
|
resource_group
|
Eine Ressourcengruppe zum Filtern der zurückgegebenen Arbeitsbereiche. Bei None listet die Methode alle Arbeitsbereiche im angegebenen Abonnement auf. Standardwert: None
|
Gibt zurück
Typ | Beschreibung |
---|---|
Ein Wörterbuch, bei dem der Schlüssel der Name des Arbeitsbereichs und der Wert eine Liste von Arbeitsbereichsobjekten ist. |
list_connections
Listen Sie die Verbindungen in diesem Arbeitsbereich auf.
list_connections(category=None, target=None)
Parameter
Name | Beschreibung |
---|---|
type
Erforderlich
|
Der Verbindungstyp, nach dem gefiltert wird |
target
|
Das Verbindungsziel, nach dem gefiltert wird Standardwert: None
|
category
|
Standardwert: None
|
list_keys
Listen Sie die Schlüssel für den aktuellen Arbeitsbereich auf.
list_keys()
Gibt zurück
Typ | Beschreibung |
---|---|
set_connection
Fügen Sie eine Verbindung im Arbeitsbereich hinzu oder aktualisieren Sie diese.
set_connection(name, category, target, authType, value)
Parameter
Name | Beschreibung |
---|---|
name
Erforderlich
|
Der eindeutige Name der Verbindung im Arbeitsbereich |
category
Erforderlich
|
Die Kategorie dieser Verbindung |
target
Erforderlich
|
Das Ziel dieser Verbindung |
authType
Erforderlich
|
Der Autorisierungstyp dieser Verbindung |
value
Erforderlich
|
Die Serialisierungszeichenfolge der Verbindungsdetails im JSON-Format |
set_default_datastore
Legen Sie den Standarddatenspeicher für den Arbeitsbereich fest.
set_default_datastore(name)
Parameter
Name | Beschreibung |
---|---|
name
Erforderlich
|
Der Name des Datastore, der als Standard festgelegt werden soll. |
setup
Erstellen eines neuen Arbeitsbereichs oder Abrufen eines vorhandenen Arbeitsbereichs.
static setup()
Gibt zurück
Typ | Beschreibung |
---|---|
Ein Arbeitsbereichsobjekt. |
sync_keys
Löst eine sofortige Schlüsselsynchronisierung im Arbeitsbereich aus.
Wenn Schlüssel für Ressourcen im Arbeitsbereich geändert werden, kann es etwa eine Stunde dauern, bis diese automatisch aktualisiert werden. Mit dieser Funktion können Schlüssel auf Anforderung aktualisiert werden. Sie kann z. B. verwendet werden, wenn nach dem erneuten Generieren von Speicherschlüsseln der sofortige Zugriff auf den Speicher erforderlich ist.
sync_keys(no_wait=False)
Parameter
Name | Beschreibung |
---|---|
no_wait
|
Gibt an, ob auf den Abschluss der Schlüsselsynchronisierung im Arbeitsbereich gewartet werden soll. Standardwert: False
|
Gibt zurück
Typ | Beschreibung |
---|---|
Bei erfolgreicher Ausführung wird nichts zurückgegeben. Andernfalls wird ein Fehler ausgelöst. |
update
Aktualisieren von Anzeigename, Beschreibung, Tags, Computename für die Imageerstellung und anderen Einstellungen eines Arbeitsbereichs.
update(friendly_name=None, description=None, tags=None, image_build_compute=None, service_managed_resources_settings=None, primary_user_assigned_identity=None, allow_public_access_when_behind_vnet=None, v1_legacy_mode=None)
Parameter
Name | Beschreibung |
---|---|
friendly_name
|
Ein Anzeigename für den Arbeitsbereich, der auf der Benutzeroberfläche angezeigt werden kann. Standardwert: None
|
description
|
Eine Beschreibung des Arbeitsbereichs. Standardwert: None
|
tags
|
Tags, die dem Arbeitsbereich zugeordnet werden sollen. Standardwert: None
|
image_build_compute
|
Der Computename für die Imageerstellung. Standardwert: None
|
service_managed_resources_settings
|
<xref:azureml._base_sdk_common.workspace.models.ServiceManagedResourcesSettings>
Die vom Dienst verwalteten Ressourceneinstellungen. Standardwert: None
|
primary_user_assigned_identity
|
Die Ressourcen-ID für die benutzerseitig zugewiesene Identität, die die Arbeitsbereichsidentität darstellt. Standardwert: None
|
allow_public_access_when_behind_vnet
|
Zulassen des öffentlichen Zugriffs auf den Private Link-Arbeitsbereich. Standardwert: None
|
v1_legacy_mode
|
Verhindern der Verwendung des v2-API-Diensts in öffentlichen Azure-Resource Manager Standardwert: None
|
Gibt zurück
Typ | Beschreibung |
---|---|
Ein Wörterbuch mit aktualisierten Informationen. |
update_dependencies
Aktualisieren der vorhandenen zugeordneten Ressourcen für den Arbeitsbereich. Diese Methode kann in folgenden Fällen verwendet werden.
a) Wenn ein Benutzer versehentlich eine vorhandene zugeordnete Ressource löscht und diese mit einer neuen Ressource aktualisieren möchte, ohne den gesamten Arbeitsbereich neu erstellen zu müssen. b) Wenn ein Benutzer über eine vorhandene zugeordnete Ressource verfügt und die Ressource ersetzen möchte, die dem Arbeitsbereich aktuell zugeordnet ist. c) Wenn noch keine zugeordnete Ressource erstellt wurde und eine bereits vorhandene Ressource verwendet werden soll (gilt nur für die Containerregistrierung).
update_dependencies(container_registry=None, force=False)
Parameter
Name | Beschreibung |
---|---|
container_registry
|
Die ARM-ID für die Containerregistrierung. Standardwert: None
|
force
|
Bei der Verwendung von „force“ werden abhängige Ressourcen ohne Bestätigungsaufforderung aktualisiert. Standardwert: False
|
Gibt zurück
Typ | Beschreibung |
---|---|
write_config
Schreiben Sie die Azure Resource Manager (ARM)-Eigenschaften des Arbeitsbereichs in eine Konfigurationsdatei.
Die ARM-Eigenschaften des Arbeitsbereichs können später mit der from_config-Methode geladen werden. Der Standardwert von path
ist „.azureml/“ im aktuellen Arbeitsverzeichnis. Der Standardwert von file_name
ist „config.json“.
Diese Methode ermöglicht die einfache Wiederverwendung des gleichen Arbeitsbereichs in mehreren Python-Notebooks oder -Projekten. Benutzer können die ARM-Eigenschaften des Arbeitsbereichs mithilfe dieser Funktion speichern und den gleichen Arbeitsbereich mit from_config in verschiedene Python-Notebooks oder -Projekte laden, ohne die ARM-Eigenschaften des Arbeitsbereichs erneut eingeben zu müssen.
write_config(path=None, file_name=None)
Parameter
Name | Beschreibung |
---|---|
path
|
Ein vom Benutzer angegebener Speicherort zum Schreiben der Datei „config.json“. Der Standardwert dieses Parameters ist im aktuellen Arbeitsverzeichnis azureml/. Standardwert: None
|
file_name
|
Der Name, der für die Konfigurationsdatei verwendet werden soll. Der Standardwert dieses Parameters ist config.json. Standardwert: None
|
Attribute
compute_targets
Auflisten aller Computeziele im Arbeitsbereich.
Gibt zurück
Typ | Beschreibung |
---|---|
Ein Wörterbuch, bei dem der Schlüssel der Name des Computeziels und der Wert ein ComputeTarget-Objekt ist. |
datasets
Auflisten aller Datasets im Arbeitsbereich.
Gibt zurück
Typ | Beschreibung |
---|---|
Ein Wörterbuch, bei dem der Schlüssel der Name des Datasets und der Wert ein Dataset-Objekt ist. |
datastores
Auflisten aller Datenspeicher im Arbeitsbereich. Dieser Vorgang gibt die Anmeldeinformationen der Datenspeicher nicht zurück.
Gibt zurück
Typ | Beschreibung |
---|---|
Ein Wörterbuch, bei dem der Schlüssel der Name des Datenspeichers und der Wert ein Datastore-Objekt ist. |
discovery_url
Dient zum Zurückgeben der Ermittlungs-URL dieses Arbeitsbereichs.
Gibt zurück
Typ | Beschreibung |
---|---|
Die Ermittlungs-URL dieses Arbeitsbereichs. |
environments
Auflisten aller Umgebungen im Arbeitsbereich.
Gibt zurück
Typ | Beschreibung |
---|---|
Ein Wörterbuch, bei dem der Schlüssel der Name der Umgebung und der Wert ein Environment-Objekt ist. |
experiments
Auflisten aller Experimente im Arbeitsbereich.
Gibt zurück
Typ | Beschreibung |
---|---|
Ein Wörterbuch, bei dem der Schlüssel der Name des Experiments und der Wert ein Experiment-Objekt ist. |
images
Geben Sie die Liste der Images im Arbeitsbereich.
Löst eine WebserviceException aus, wenn bei der Interaktion mit dem Modellverwaltungsdienst ein Problem aufgetreten ist.
Gibt zurück
Typ | Beschreibung |
---|---|
Ein Wörterbuch, bei dem der Schlüssel der Name des Images und der Wert ein Image-Objekt ist. |
Ausnahmen
Typ | Beschreibung |
---|---|
Bei der Interaktion mit dem Modellverwaltungsdienst ist ein Problem aufgetreten. |
linked_services
Auflisten aller verknüpften Dienste im Arbeitsbereich.
Gibt zurück
Typ | Beschreibung |
---|---|
Ein Wörterbuch, bei dem der Schlüssel der Name des verknüpften Diensts und der Wert ein LinkedService-Objekt ist. |
location
Geben Sie den Speicherort dieses Arbeitsbereichs zurück.
Gibt zurück
Typ | Beschreibung |
---|---|
Der Speicherort des Arbeitsbereichs. |
models
Geben Sie eine Liste der Modelle im Arbeitsbereich zurück.
Löst eine WebserviceException aus, wenn bei der Interaktion mit dem Modellverwaltungsdienst ein Problem aufgetreten ist.
Gibt zurück
Typ | Beschreibung |
---|---|
Ein Wörterbuch von Modellen, bei dem der Schlüssel der Name des Modells und der Wert ein Model-Objekt ist. |
Ausnahmen
Typ | Beschreibung |
---|---|
Bei der Interaktion mit dem Modellverwaltungsdienst ist ein Problem aufgetreten. |
name
Geben Sie den Namen des Arbeitsbereichs zurück.
Gibt zurück
Typ | Beschreibung |
---|---|
Der Arbeitsbereichsname. |
private_endpoints
Listen Sie alle privaten Endpunkte des Arbeitsbereichs auf.
Gibt zurück
Typ | Beschreibung |
---|---|
Ein Wörterbuch von PrivateEndPoint-Objekten, die dem Arbeitsbereich zugeordnet sind. Der Schlüssel ist der Name des privaten Endpunkts. |
resource_group
Geben Sie den Namen der Ressourcengruppe für diesen Arbeitsbereich zurück.
Gibt zurück
Typ | Beschreibung |
---|---|
Der Name der Ressourcengruppe. |
service_context
Geben Sie den Dienstkontext für diesen Arbeitsbereich zurück.
Gibt zurück
Typ | Beschreibung |
---|---|
<xref:azureml._restclient.service_context.ServiceContext>
|
Geben Sie das ServiceContext-Objekt zurück. |
sku
Geben Sie die SKU dieses Arbeitsbereichs zurück.
Gibt zurück
Typ | Beschreibung |
---|---|
Die SKU dieses Arbeitsbereichs. |
subscription_id
Geben Sie die Abonnement-ID für diesen Arbeitsbereich zurück.
Gibt zurück
Typ | Beschreibung |
---|---|
Die Abonnement-ID. |
tags
Geben Sie die Tags dieses Arbeitsbereichs zurück.
Gibt zurück
Typ | Beschreibung |
---|---|
Die Tags dieses Arbeitsbereichs. |
webservices
Geben Sie eine Liste der Webdienste im Arbeitsbereich zurück.
Löst eine WebserviceException aus, wenn beim Zurückgeben der Liste ein Problem aufgetreten ist.
Gibt zurück
Typ | Beschreibung |
---|---|
Eine Liste der Webdienste im Arbeitsbereich. |
Ausnahmen
Typ | Beschreibung |
---|---|
Beim Zurückgeben der Liste ist ein Problem aufgetreten. |
DEFAULT_CPU_CLUSTER_CONFIGURATION
DEFAULT_CPU_CLUSTER_CONFIGURATION = <azureml.core.compute.amlcompute.AmlComputeProvisioningConfiguration object>
DEFAULT_CPU_CLUSTER_NAME
DEFAULT_CPU_CLUSTER_NAME = 'cpu-cluster'
DEFAULT_GPU_CLUSTER_CONFIGURATION
DEFAULT_GPU_CLUSTER_CONFIGURATION = <azureml.core.compute.amlcompute.AmlComputeProvisioningConfiguration object>
DEFAULT_GPU_CLUSTER_NAME
DEFAULT_GPU_CLUSTER_NAME = 'gpu-cluster'