CLI (v2) Azure Blob 数据存储 YAML 架构

适用于:Azure CLI ml 扩展 v2(当前)

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 字符串 连接到容器的协议。 httpswasbs https
credentials object 用于连接到 Azure 存储帐户的基于凭据的身份验证凭据。 帐户密钥或共享访问签名 (SAS) 令牌将正常工作。 工作区密钥保管库可存储凭据机密。
credentials.account_key 字符串 用于存储帐户访问的帐户密钥。 如果指定了 credentials,则 credentials.account_keycredentials.sas_token 之一是必需的。
credentials.sas_token 字符串 用于访问存储帐户的 SAS 令牌。 如果指定了 credentials,则 credentials.account_keycredentials.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

后续步骤