注意
本文档中详细介绍的 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_blob |
azure_blob |
account_name |
字符串 | 必需。 Azure 存储帐户名称。 | ||
container_name |
字符串 | 必需。 Blob 容器名称。 | ||
is_shared |
布尔 | 如果中心内其他项目共享连接，则为 true；否则，为 false。 |
true |
|
url |
字符串 | 必需。 blob 容器的 URL。 | ||
credentials |
对象 | 基于凭据的身份验证，用于访问存储帐户。 帐户密钥或共享访问签名 (SAS) 令牌将正常工作。 使用无凭据身份验证时请勿指定 credentials。 |
||
credentials.account_key |
字符串 | 用于访问存储帐户的帐户密钥。 如果使用帐户密钥进行身份验证，请不要使用 credentials.sas_token。 |
||
credentials.sas_token |
字符串 | 用于访问存储帐户的 SAS 令牌。 如果使用 SAS 令牌进行身份验证，请不要使用 credentials.account_key。 |
注解
az ml connection虽然命令可用于管理 Azure 机器学习和 Microsoft Foundry 连接，但 blob 存储连接特定于 Foundry。
示例
这些示例将以 YAML 文件的形式显示，并通过 CLI 使用。 例如 az ml connection create -f <file-name>.yaml。
YAML：帐户密钥
#AzureBlobStoreConnection.yaml
name: my_blobstore_ak
type: azure_blob
url: "myendpoint"
container_name: dummycont
account_name: mystroageacct
credentials:
account_key: "XXXXXXXXXXX"
YAML：SAS 令牌
#AzureBlobStoreConnection.yaml
name: my_blobstore_sas
type: azure_blob
url: "myendpoint"
container_name: dummycont
account_name: mystroageacct
credentials:
sas_token: "XXXXXXX"
YAML：无凭据
#AzureBlobStoreConnection.yaml
name: my_blobstore_cl
type: azure_blob
url: "myendpoint"
container_name: dummycont
account_name: mystroageacct