YAML-Schema der Verbindung der Azure KI Services für die CLI (V2)
GILT FÜR 
Azure CLI-ML-Erweiterung v2 (aktuell)
Hinweis
Die in diesem Dokument beschriebene YAML-Syntax basiert auf dem JSON-Schema für die neueste Version der ML CLI v2-Erweiterung. Die Funktion dieser Syntax wird nur mit der neuesten Version der ML CLI v2-Erweiterung garantiert. Die Schemas für ältere Erweiterungsversionen finden Sie unter https://azuremlschemasprod.azureedge.net/.
YAML-Syntax
| Schlüssel | type | BESCHREIBUNG | Zulässige Werte | Standardwert |
|---|---|---|---|---|
$schema |
Zeichenfolge | Das YAML-Schema. Wenn Sie die Visual Studio Code-Erweiterung für Azure Machine Learning zum Erstellen einer YAML-Datei verwenden, können Sie Schema- und Ressourcenvervollständigungen aufrufen, wenn Sie am Anfang Ihrer Datei $schema einschließen. |
||
name |
Zeichenfolge | Erforderlich. Der Verbindungsname. | ||
description |
Zeichenfolge | Die Verbindungsbeschreibung. | ||
tags |
Objekt | Das Verbindungs-Tag-Wörterbuch. | ||
type |
Zeichenfolge | Erforderlich. Der Verbindungstyp. | azure_ai_services |
azure_ai_services |
is_shared |
boolean | true, wenn die Verbindung für andere Projekte im Hub freigegeben wird; andernfalls false. |
true |
|
endpoint |
Zeichenfolge | Erforderlich. Die URL des Endpunkts. | ||
api_key |
Zeichenfolge | Der API-Schlüssel, der zur Authentifizierung der Verbindung verwendet wird. Falls nicht angegeben, wird die Verbindung über die Microsoft Entra-ID (anmeldeinformationenlose Authentifizierung) authentifiziert. | ||
ai_services_resource_id |
Zeichenfolge | Erforderlich. Die vollqualifizierte Azure-Ressourcen-ID der Azure KI Services-Ressource. |
Hinweise
Es gibt zwei Möglichkeiten zum Erstellen von Verbindungen mit Azure KI Services:
- Eine Verbindung für alle Azure KI Services mit Ausnahme von Azure KI-Suche.
- Eine Verbindung für jeden einzelnen Azure KI Service.
Das in diesem Artikel beschriebene Schema gilt für eine Verbindung für alle Azure KI Services mit Ausnahme von Azure KI-Suche.
Während die az ml connection-Befehle zum Verwalten von Azure Machine Learning- und Azure KI Studio-Verbindungen verwendet werden können, ist die Azure KI Services-Verbindung spezifisch für Azure KI Studio.
Beispiele
Diese Beispiele haben das Format von YAML-Dateien und werden von der CLI verwendet. Beispiel: az ml connection create -f <file-name>.yaml.
YAML: API-Schlüssel
#AzureAIServiceConnection.yml
name: myazai_ei
type: azure_ai_services
endpoint: https://contoso.cognitiveservices.azure.com/
api_key: XXXXXXXXXXXXXXX
YAML: Microsoft Entra ID
#AzureAIServiceConnection.yml
name: myazai_apk
type: azure_ai_services
endpoint: https://contoso.cognitiveservices.azure.com/