调用CreateDataSource创建一个数据源。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求语法

POST /api/v1/datasources HTTP/1.1
Content-Type:application/json

{
  "DataSourceType" : "String",
  "DisplayName" : "String",
  "Description" : "String",
  "FileSystemId" : "String",
  "MountPath" : "String"
}

请求参数

表 1. 请求Body参数
参数名称 类型 是否必选 示例 说明
DataSourceType String nas

数据源类型,目前仅支持nas;其他存储类型即将发布,敬请期待。

DisplayName String nas-data

数据源名称,支持大小写英文字母、下划线(_)、点号(.)及短划线(-),长度不能超过64个字符。

Description String data source of dlc examples

数据源描述

FileSystemId String 1ca404****

阿里云NAS文件系统,详情见阿里云文档

Path String oss://mybucket/path/to/dir

阿里云OSS文件系统路径

Endpoint String oss-cn-beijing-internal.aliyuncs.com

阿里云OSS文件系统服务端点,用户需要配置成自己用的OSS的endpoint,不是必填的,如果不填写后端会自动给出一个合理的值

Options String {"key": "value"}

阿里云OSS文件系统配置选项

MountPath String /root/data/

本地挂载目录。如果创建任务时指定此数据源,任务运行的每一个节点会挂载此文件系统到此本地目录。如果指定相对目录,DLC会自动添加前缀/root/data/;绝对目录必须以/root/data/开头。

响应体语法

HTTP/1.1 200 OK
Content-Type:application/json

{
  "DataSourceId" : "String",
  "RequestId" : "String"
}

响应参数

表 2. 响应Body参数
参数名称 类型 示例 说明
DataSourceId String data-20210114104214-xxxxxx

数据源ID

RequestId String 473469C7-AA6F-4DC5-B3DB-xxxxxxx

本次调用的请求ID,用于诊断和答疑。

创建阿里云NAS文件系统的数据源

POST /api/v1/datasources HTTP/1.1 
Host:pai-dlc.aliyuncs.com 
Content-Type:application/json

{
  "DataSourceType" : "nas",
  "DisplayName" : "nas-data",
  "Description" : "data source of dlc examples",
  "FileSystemId" : "1ca404****",
  "MountPath" : "/root/data/"
}

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DataSourceId>data-20210114104214-xxxxxx</DataSourceId>
<RequestId>473469C7-AA6F-4DC5-B3DB-xxxxxxx</RequestId>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "DataSourceId" : "data-20210114104214-xxxxxx",
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-xxxxxxx"
}

错误码

访问错误中心查看更多错误码。

开发者资源

  • SDK

    阿里云为您提供多种语言的SDK,帮助您快速通过API集成阿里云的产品和服务,推荐您使用SDK调用API,已免除您手动签名验证。

  • OpenAPI Explorer

    快速检索,可视化调试API,在线命令行工具,同步动态生成可执行的SDK代码示例。

  • 阿里云CLI

    阿里云资产管理和配置工具,可通过命令方式同时管理多个阿里云产品和服务,简单快捷,是您上云好帮手。