调用CreateDataset API创建数据集-大数据开发治理平台 DataWorks-阿里云-大数据开发治理平台 DataWorks(DataWorks)-阿里云帮助中心

创建数据集，仅支持在用户已加入的工作空间创建数据集且当前仅支持创建DataWorks数据集，单租户下限制数据集最大数量为2000

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

dataworks:CreateDataset

create

*全部资源

*

无

请求语法

POST  HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
ProjectId	integer	是	DataWorks 工作空间 ID	12345
Origin	string	否	数据集来源，当前仅支持 DataWorks 枚举值： DataWorks : DataWorks	DataWorks
Name	string	是	数据集名称，非空字符串，长度不超过 128	test_oss_dataset
Comment	string	否	数据集描述,长度不超过 1024	this is a comment
DataType	string	否	数据类型，取值有 COMMON 通用（默认） PIC 图片 TEXT 文本 TABLE 表格 VIDEO 视频 AUDIO 音频 INDEX 索引枚举值： TABLE : 表格 VIDEO : 视频 COMMON : 通用 TEXT : 文本 PIC : 图片 INDEX : 索引 AUDIO : 音频	COMMON
StorageType	string	是	存储类型，当前支持的取值有 OSS 对象存储 NAS 通用型 NAS 文件存储 EXTREMENAS 极速型 NAS 文件存储 DLF_LANCE 数据湖构建枚举值： NAS : 通用型 NAS 文件存储 EXTREMENAS : 极速型 NAS 文件存储 OSS : 对象存储 DLF_LANCE : 数据湖构建	OSS
InitVersion	object	是	数据集初始版本
Comment	string	否	描述，长度不超过 1024	Initial Version
Url	string	是	URL 地址	oss://test-oss-bucket/test_dir/
ImportInfo	object	否	数据集的存储导入配置, 对于不同存储类型，需要的配置信息不同 NAS 取值可参考文件存储 API DescribeFileSystems 的返回信息 `{ "fileSystemId": "3b6XXX89c9", // 文件系统 ID "fileSystemStorageType": "Performance", // 文件系统的存储规格 "vpcId": "vpc-uf66oxxxrqge1t2gson7s" // 挂载点的 VPC ID }`
	string	否	数据集的存储导入配置信息	None
MountPath	string	否	挂载路径，需要以/mnt/开头，默认为/mnt/data	/mnt/data

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	Id of the request	99EBE7CF-69C0-5089-BE3E-79563C31XXXX
Success	boolean	是否创建成功	true
Id	string	ID	dataworks-dataset:3pXXXb8o0ngr07njhps1

示例

正常返回示例

JSON格式

{
  "RequestId": "99EBE7CF-69C0-5089-BE3E-79563C31XXXX",
  "Success": true,
  "Id": "dataworks-dataset:3pXXXb8o0ngr07njhps1"
}

错误码

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

变更历史

更多信息，参考变更详情。