CLI (v2) Azure Blob 数据存储 YAML 架构
在 https://azuremlschemas.azureedge.net/latest/azureBlob.schema.json 中查看源 JSON 架构。
注意
本文档中详细介绍的 YAML 语法基于最新版本的 ML CLI v2 扩展的 JSON 架构。 此语法必定仅适用于最新版本的 ML CLI v2 扩展。 可以在 https://azuremlschemasprod.azureedge.net/ 上查找早期扩展版本的架构。
YAML 语法
密钥 | 类型 | 说明 | 允许的值 | 默认值 |
---|---|---|---|---|
$schema |
字符串 | YAML 架构。 如果使用 Azure 机器学习 Visual Studio Code 扩展来创作 YAML 文件,请在该文件的顶部添加 $schema 以调用架构和资源完成。 |
||
type |
string | 必需。 数据存储类型。 | azure_blob |
|
name |
字符串 | 必需。 数据存储名称。 | ||
description |
字符串 | 数据存储说明。 | ||
tags |
object | 数据存储标记字典。 | ||
account_name |
字符串 | 必需。 Azure 存储帐户名称。 | ||
container_name |
字符串 | 必需。 容器名称。 | ||
endpoint |
字符串 | 存储服务的终结点后缀,用于创建存储帐户终结点 URL。 它将存储帐户名称和 endpoint 组合在一起。 示例存储帐户 URL:https://<storage-account-name>.blob.core.chinacloudapi.cn 。 |
core.chinacloudapi.cn |
|
protocol |
字符串 | 连接到容器的协议。 | https 、wasbs |
https |
credentials |
object | 用于连接到 Azure 存储帐户的基于凭据的身份验证凭据。 帐户密钥或共享访问签名 (SAS) 令牌将正常工作。 工作区密钥保管库可存储凭据机密。 | ||
credentials.account_key |
字符串 | 用于存储帐户访问的帐户密钥。 如果指定了 credentials ,则 credentials.account_key 或 credentials.sas_token 之一是必需的。 |
||
credentials.sas_token |
字符串 | 用于访问存储帐户的 SAS 令牌。 如果指定了 credentials ,则 credentials.account_key 或 credentials.sas_token 之一是必需的。 |
备注
可以使用 az ml datastore
命令来管理 Azure 机器学习数据存储。
示例
有关示例,请访问此 GitHub 资源。 下面显示了几个示例:
YAML:基于标识的访问
$schema: https://azuremlschemas.azureedge.net/latest/azureBlob.schema.json
name: blob_credless_example
type: azure_blob
description: Credential-less datastore pointing to a blob container.
account_name: mytestblobstore
container_name: data-container
YAML:帐户密钥
$schema: https://azuremlschemas.azureedge.net/latest/azureBlob.schema.json
name: blob_example
type: azure_blob
description: Datastore pointing to a blob container.
account_name: mytestblobstore
container_name: data-container
credentials:
account_key: XXXxxxXXXxXXXXxxXXXXXxXXXXXxXxxXxXXXxXXXxXXxxxXXxxXXXxXxXXXxxXxxXXXXxxxxxXXxxxxxxXXXxXXX
YAML:wasbs 协议
$schema: https://azuremlschemas.azureedge.net/latest/azureBlob.schema.json
name: blob_protocol_example
type: azure_blob
description: Datastore pointing to a blob container using wasbs protocol.
account_name: mytestblobstore
protocol: wasbs
container_name: data-container
credentials:
account_key: XXXxxxXXXxXXXXxxXXXXXxXXXXXxXxxXxXXXxXXXxXXxxxXXxxXXXxXxXXXxxXxxXXXXxxxxxXXxxxxxxXXXxXXX
YAML:SAS 令牌
$schema: https://azuremlschemas.azureedge.net/latest/azureBlob.schema.json
name: blob_sas_example
type: azure_blob
description: Datastore pointing to a blob container using SAS token.
account_name: mytestblobstore
container_name: data-container
credentials:
sas_token: ?xx=XXXX-XX-XX&xx=xxxx&xxx=xxx&xx=xxxxxxxxxxx&xx=XXXX-XX-XXXXX:XX:XXX&xx=XXXX-XX-XXXXX:XX:XXX&xxx=xxxxx&xxx=XXxXXXxxxxxXXXXXXXxXxxxXXXXXxxXXXXXxXXXXxXXXxXXxXX