Schema YAML della connessione ai servizi di Azure AI dell'interfaccia della riga di comando (v2)
SI APPLICA A: 
estensione ML dell'interfaccia della riga di comando di Azure v2 (corrente)
Nota
La sintassi YAML descritta in dettaglio in questo documento si basa sullo schema JSON per la versione più recente dell'estensione dell'interfaccia della riga di comando di Machine Learning v2. Il funzionamento di questa sintassi è garantito solo con la versione più recente dell'estensione dell'interfaccia della riga di comando di Machine Learning v2. È possibile trovare gli schemi per le versioni di estensione precedenti in https://azuremlschemasprod.azureedge.net/.
Sintassi YAML
| Chiave | Type | Descrizione | Valori consentiti | Valore predefinito |
|---|---|---|---|---|
$schema |
string | Schema YAML. Se si usa l'estensione Azure Machine Learning per Visual Studio Code per creare il file YAML, includere $schema nella parte superiore del file per richiamare i completamenti dello schema e delle risorse. |
||
name |
string | Obbligatorio. Nome della connessione. | ||
description |
string | Descrizione della connessione. | ||
tags |
oggetto | Dizionario di tag della connessione. | ||
type |
string | Obbligatorio. Tipo di connessione. | azure_ai_services |
azure_ai_services |
is_shared |
boolean | true se la connessione viene condivisa tra altri progetti nell'hub. In caso contrario, false. |
true |
|
endpoint |
string | Obbligatorio. URL dell'endpoint. | ||
api_key |
string | Chiave API usata per autenticare la connessione. Se non specificato, la connessione viene autenticata tramite Microsoft Entra ID (autenticazione senza credenziali). | ||
ai_services_resource_id |
string | Obbligatorio. ID risorsa di Azure completo della risorsa servizi di intelligenza artificiale di Azure. |
Osservazioni:
Esistono due modi per creare connessioni ai servizi di intelligenza artificiale di Azure:
- Una connessione per tutti i servizi di intelligenza artificiale di Azure ad eccezione di Ricerca di intelligenza artificiale di Azure.
- Una connessione per ogni singolo servizio di intelligenza artificiale di Azure.
Lo schema descritto in questo articolo è relativo a una connessione per tutti i servizi di intelligenza artificiale di Azure ad eccezione di Ricerca di intelligenza artificiale di Azure.
Anche se i comandi di az ml connection possono essere usati per gestire sia le connessioni di Azure Machine Learning che di Studio AI della piattaforma Azure, la connessione di Servizi di Azure AI è specifica di Studio AI della piattaforma Azure.
Esempi
Questi esempi sono sotto forma di file YAML e vengono usati dall'interfaccia della riga di comando. Ad esempio: az ml connection create -f <file-name>.yaml.
YAML: chiave API
#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/