Esquema YAML de conexión de Azure AI Services de la CLI (v2)
SE APLICA A: 
Extensión de ML de la CLI de Azure v2 (actual)
Nota:
La sintaxis de YAML que se detalla en este documento se basa en el esquema JSON de la versión más reciente de la extensión ML de la CLI v2. Se garantiza que esta sintaxis solo funciona con la versión más reciente de la extensión ML de la CLI v2. Dispone de los esquemas de las versiones de anteriores de la extensión en https://azuremlschemasprod.azureedge.net/.
Sintaxis de YAML
| Clave | Tipo | Descripción | Valores permitidos | Valor predeterminado |
|---|---|---|---|---|
$schema |
string | Esquema de YAML. Si usa la extensión Visual Studio Code de Azure Machine Learning para crear el archivo YAML, incluya $schema en la parte superior del archivo para invocar las finalizaciones del esquema y los recursos. |
||
name |
string | Necesario. Nombre de la conexión. | ||
description |
string | Descripción de la conexión. | ||
tags |
objeto | Diccionario de etiquetas de la conexión. | ||
type |
string | Necesario. Tipo de conexión. | azure_ai_services |
azure_ai_services |
is_shared |
boolean | true si la conexión se comparte entre otros proyectos del centro; de lo contrario, false. |
true |
|
endpoint |
string | Necesario. La dirección URL del extremo. | ||
api_key |
string | Necesario. Clave de API usada para autenticar la conexión. Si no se proporciona, se crea una conexión de Microsoft Entra ID (autenticación sin credenciales). | ||
ai_services_resource_id |
string | Necesario. Identificador completo de recurso de Azure del recurso de Azure AI Services. |
Comentarios
Hay dos maneras de crear conexiones a Azure AI Services:
- Una conexión para todos los servicios de Azure AI, excepto Azure AI Search.
- Una conexión para cada servicio de Azure AI individual.
El esquema descrito en este artículo es para una conexión para todos los servicios de Azure AI, excepto Azure AI Search.
Aunque los comandos az ml connection se pueden usar para administrar las conexiones de Azure Machine Learning e Inteligencia artificial de Azure Studio, la conexión de Servicios de Azure AI es específica de Inteligencia artificial de Azure Studio.
Ejemplos
Estos ejemplos tendrían formato de archivos YAML y se usarían desde la CLI. Por ejemplo, az ml connection create -f <file-name>.yaml.
YAML: clave de API
#AzureAIServiceConnection.yml
name: myazai_ei
type: azure_ai_services
endpoint: https://contoso.cognitiveservices.azure.com/
api_key: XXXXXXXXXXXXXXX
YAML: sin credenciales
#AzureAIServiceConnection.yml
name: myazai_apk
type: azure_ai_services
endpoint: https://contoso.cognitiveservices.azure.com/