Schéma YAML des connexions Azure AI Services avec CLI (v2)
S’APPLIQUE À : 
Extension ml Azure CLI v2 (actuelle)
Remarque
La syntaxe YAML détaillée dans ce document est basée sur le schéma JSON pour la dernière version de l’extension ML CLI v2. Le fonctionnement de cette syntaxe est garanti uniquement avec la dernière version de l’extension ML CLI v2. Vous trouverez les schémas des versions d’extension plus anciennes sur https://azuremlschemasprod.azureedge.net/.
Syntaxe YAML
| Clé | Type | Description | Valeurs autorisées | Valeur par défaut |
|---|---|---|---|---|
$schema |
string | Schéma YAML. Si vous utilisez l’extension de Visual Studio Code pour Azure Machine Learning afin de créer le fichier YAML, incluez $schema en haut de votre fichier pour appeler les complétions du schéma et de la ressource. |
||
name |
string | Obligatoire. Nom de la connexion. | ||
description |
string | La description de la connexion. | ||
tags |
object | Le dictionnaire des étiquettes de connexion. | ||
type |
string | Obligatoire. Type de la connexion. | azure_ai_services |
azure_ai_services |
is_shared |
booléen | true si la connexion est partagée avec d’autres projets du hub. Sinon, false. |
true |
|
endpoint |
string | Obligatoire. URL du point de terminaison. | ||
api_key |
string | La clé API utilisée pour authentifier la connexion. Si elle n’est pas fournie, la connexion est authentifiée via l’ID Microsoft Entra (authentification sans informations d’identification). | ||
ai_services_resource_id |
string | Obligatoire. L’ID de ressource Azure complet de la ressource Azure AI Services. |
Notes
Il existe deux façons de créer des connexions à Azure AI Services :
- Une connexion pour tous les services Azure AI Services, à l’exception de Recherche Azure AI.
- Une connexion pour chaque service Azure AI individuel.
Le schéma décrit dans cet article concerne une connexion pour tous les services Azure AI Services, à l’exception de Recherche Azure AI.
Même si les commandes az ml connection peuvent être utilisées pour gérer à la fois les connexions Azure Machine Learning et Azure AI Studio, la connexion Azure AI Services est spécifique à Azure AI Studio.
Exemples
Ces exemples sont sous la forme de fichiers YAML et utilisés à partir de l’interface CLI. Par exemple : az ml connection create -f <file-name>.yaml.
YAML : clé API
#AzureAIServiceConnection.yml
name: myazai_ei
type: azure_ai_services
endpoint: https://contoso.cognitiveservices.azure.com/
api_key: XXXXXXXXXXXXXXX
YAML : ID Microsoft Entra
#AzureAIServiceConnection.yml
name: myazai_apk
type: azure_ai_services
endpoint: https://contoso.cognitiveservices.azure.com/