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

  • 项目

适用于：Azure CLI ml 扩展 v2（当前版）

源 JSON 架构可在 https://azuremlschemas.azureedge.net/latest/azureBlob.schema.json 中找到。

注意

本文档中详细介绍的 YAML 语法基于最新版本的 ML CLI v2 扩展的 JSON 架构。 此语法必定仅适用于最新版本的 ML CLI v2 扩展。 可以在 https://azuremlschemasprod.azureedge.net/ 上查找早期扩展版本的架构。

YAML 语法

密钥 类型 说明 允许的值 默认值
$schema 字符串 YAML 架构。 如果使用 Azure 机器学习 VS Code 扩展来创作 YAML 文件，则可通过在文件顶部包含 $schema 来调用架构和资源完成操作。
type 字符串 必需。 数据存储的类型。 azure_blob
name 字符串 必需。 数据存储的名称。
description 字符串 数据存储的说明。
tags object 数据存储的标记字典。
account_name 字符串 必需。 Azure 存储帐户的名称。
container_name 字符串 必需。 容器名。
endpoint string 存储服务的终结点后缀，用于通过组合存储帐户名和 endpoint 来创建存储帐户终结点 URL。 示例存储帐户 URL：https://<storage-account-name>.blob.core.chinacloudapi.cn。 core.chinacloudapi.cn
protocol string 用于连接到容器的协议。 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

后续步骤