CreateDataset - 创建数据集

更新时间: 2023-11-27 11:05:51

调用CreateDataset创建一个数据集。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST /api/v1/datasets

请求参数

名称类型必填描述示例值
bodyobject

请求体。

Namestring

数据集的名称。命名规则如下:

  • 以小写字母、大写字母、数字或中文开头。
  • 可以包含下划线(_)或短划线(-)。
  • 长度为1~127个字符。
myName
Propertystring

数据集的属性。支持以下取值:

  • FILE:文件。
  • DIRECTORY:文件夹。
DIRECTORY
DataSourceTypestring

数据源类型。支持以下取值:

  • OSS:阿里云对象存储(OSS)。
  • NAS:阿里云文件存储(NAS)。
NAS
Uristring

Uri配置样例如下:

  • 数据源类型为OSS:oss://bucket.endpoint/object
  • 数据源类型为NAS: 通用型NAS格式为:nas://<nasfisid>.region/subpath/to/dir/; CPFS1.0:nas://<cpfs-fsid>.region/subpath/to/dir/; CPFS2.0:nas://<cpfs-fsid>.region/<protocolserviceid>/。 CPFS1.0和CPFS2.0根据fsid的格式来区分:CPFS1.0 格式为cpfs-<8位ascii字符>;CPFS2.0 格式为cpfs-<16位ascii字符>。
nas://09f****f2.cn-hangzhou/
DataTypestring

数据集类型,默认为COMMON。支持以下取值:

  • COMMON:普通。
  • PIC:图片。
  • TEXT:文本。
  • VIDEO:视频。
  • AUDIO:音频。
COMMON
Labelsarray

标签列表。

Label

为数据集添加的标签。

SourceTypestring

数据来源类型,默认为USER。支持以下取值:

  • PAI-PUBLIC-DATASET:PAI公共数据集。
  • ITAG:iTAG模块标注结果生成的数据集。
  • USER:用户注册的数据集。
枚举值:
  • PAI_PUBLIC_DATASETPAI_PUBLIC_DATASET
  • ITAGITAG
  • USERUSER
USER
SourceIdstring

数据来源ID。

  • 当SourceType为USER时,SourceId支持自定义。
  • 当SourceType为ITAG时,即iTAG模块标注结果生成的数据集时,SourceId为ITAG的任务ID。
  • 当SourceType为PAI_PUBLIC_DATASET时,即使用PAI公共数据集创建的数据集时,SourceId默认为空。
jdnhf***fnrimv
Descriptionstring

对数据集进行自定义描述,以区分不同的数据集。

用于标注的数据。
WorkspaceIdstring

数据集所在工作空间ID。如何获取工作空间ID,请参见ListWorkspaces。 如果不配置该参数,则会使用默认工作空间;如果默认工作空间不存在,则会报错。

478**
Optionsstring

扩展字段,JsonString类型。 当DLC使用数据集时,可通过配置mountPath字段指定数据集默认挂载路径。

{ "mountPath": "/mnt/data/" }
Accessibilitystring

工作空间可见度。支持以下取值:

  • PRIVATE(默认值):表示工作空间内自己以及管理员可见。
  • PUBLIC为:工作空间所有用户可见。
PRIVATE
ProviderTypestring

数据集的数据源来源类型,支持配置的类型如下:

  • Ecs(默认值)
  • Lingjun
Ecs

返回参数

名称类型描述示例值
object

返回体。

RequestIdstring

请求ID。

B2C51F93-1C07-5477-9705-5FDB****F19F
DatasetIdstring

数据集ID。

d-rbvg5*****jhc9ks92

示例

正常返回示例

JSON格式

{
  "RequestId": "B2C51F93-1C07-5477-9705-5FDB****F19F",
  "DatasetId": "d-rbvg5*****jhc9ks92"
}

错误码

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

变更历史

变更时间变更内容概要操作
2023-04-26API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
阿里云首页 人工智能平台 PAI 相关技术圈