注意
本文档中详细介绍的 YAML 语法基于最新版本的 ML CLI v2 扩展的 JSON 架构。 此语法必定仅适用于最新版本的 ML CLI v2 扩展。 可以在 https://azuremlschemasprod.azureedge.net/ 上查找早期扩展版本的架构。
YAML 语法
| 密钥 | 类型 | 说明 | 允许的值 | 默认值 |
|---|---|---|---|---|
$schema |
字符串 | YAML 架构。 如果使用 Azure 机器学习 Visual Studio Code 扩展来创作 YAML 文件，请在该文件的顶部添加 $schema 以调用架构和资源完成。 |
||
name |
字符串 | 必需。 连接名称。 | ||
description |
字符串 | 连接描述。 | ||
tags |
物体 | 连接标记字典。 | ||
type |
字符串 | 必需。 连接类型。 | azure_speech_services |
azure_speech_services |
is_shared |
布尔 | 如果中心内其他项目共享连接，则为 true；否则，为 false。 |
true |
|
endpoint |
字符串 | 必需。 此连接的 Azure AI 服务终结点。 | ||
api_key |
字符串 | 必需。 用于对连接进行身份验证的 API 密钥。 如果未提供，则会创建 Microsoft Entra ID（无凭据身份验证）。 |
注解
本文中所述的架构仅用于创建与 Azure AI 语音服务的连接。 如果更倾向于为 Azure AI 服务创建单个连接，请参阅 Azure AI 服务连接架构。
az ml connection虽然命令可用于管理Azure 机器学习和 Azure AI Foundry 连接，但 Azure AI 语音服务连接特定于 Azure AI Foundry。
示例
这些示例将以 YAML 文件的形式显示，并通过 CLI 使用。 例如 az ml connection create -f <file-name>.yaml。
YAML：API 密钥
#AzureContentSafetyConnection.yml
name: myazaics_apk
type: azure_content_safety
endpoint: https://contoso.cognitiveservices.azure.com/
api_key: XXXXXXXXXXXXXXX
YAML：无凭据
#AzureContentSafetyConnection.yml
name: myazaics_ei
type: azure_content_safety
endpoint: https://contoso.cognitiveservices.azure.com/