创建数据集
更新时间：2025-07-09
接口描述
创建数据集，同时创建一个初始版本。
权限说明
鉴权认证机制的详细内容请参见鉴权认证。
请求结构
Bash
1POST ?action=CreateDataset
2HTTP/1.1
3Host: aihc.bj.baidubce.com
4Authorization: authorization string
5version: v2请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 参数描述 |
|---|---|---|---|---|
| name | String | 是 | Body参数 | 数据集名称支持小写字母、数字和-，必须以小写字母开头，必须以小写字母或数字结尾，长度限制1-50。 |
| storageType | String | 是 | Body参数 | 存储类型，可选项：PFS、BOS |
| storageInstance | String | 是 | Body参数 | 存储实例ID，对应PFS、BOS的ID |
| importFormat | String | 是 | Body参数 | 导入格式 FILE：文件 FOLDER：文件夹 |
| description | String | 否 | Body参数 | 数据集的描述 |
| owner | String | 否 | Body参数 | 所有者，不传递时默认为创建者 |
| visibilityScope | String | 是 | Body参数 | 可见范围 ALL_PEOPLE：所有人可见 ONLY_OWNER：仅所有者可读写 USER_GROUP：指定范围可用 |
| visibilityUser | List<PermissionEntry> | 否 | Body参数 | 用户权限列表 [{"id": "xxx", "name": "xxx", "permission": "r"}, {"id": "yyy", "name": "xxx", "permission": "rw"}] |
| visibilityGroup | List<PermissionEntry> | 否 | Body参数 | 用户组权限列表 [{"id": "xxx", "name": "xxx", "permission": "r"}, {"id": "yyy", "name": "xxx", "permission": "rw"}] |
| initVersionEntry | DatasetVersionEntry | 是 | Body参数 | 初始版本相关信息 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | String | 数据集ID |
请求示例
JSON
1{
2 "name": "test1",
3 "storageType": "BOS",
4 "storageInstance": "bucket1",
5 "importFormat": "FOLDER",
6 "description": "test dataset",
7 "owner": "d1a5cf0143be4de9911342051106f70f",
8 "visibilityScope": "USER_GROUP",
9 "visibilityUser": [
10 {
11 "id": "ebcf430f84b046cca9fe1c62e3d739bc",
12 "name": "lisi",
13 "permission": "r"
14 },
15 {
16 "id": "f410f7b6ee5b48a7a2bd7f3675bc19e0",
17 "name": "wangwu",
18 "permission": "rw"
19 }
20 ],
21 "initVersionEntry": {
22 "description": "dataset first version",
23 "storagePath": "/path/to/dir",
24 "mountPath": "/mnt/datasets/test1"
25 }
26}响应示例
JSON
1{
2 "requestId": "e643706e-7491-4eba-b8cf-1529fa25653d",
3 "id": "ds-iIkcJJZp"
4}