获取数据集详情
更新时间：2025-06-18
接口描述
获取数据集详情，同时返回最新版本信息。
权限说明
鉴权认证机制的详细内容请参见鉴权认证。
请求结构
Bash
1GET ?action=DescribeDataset&datasetId=xxx
2HTTP/1.1
3Host: aihc.bj.baidubce.com
4Authorization: authorization string
5version: v2请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 参数描述 |
|---|---|---|---|---|
| datasetId | String | 是 | Query参数 | 数据集ID |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | String | 数据集ID |
| name | String | 数据集名称 |
| storageType | String | 存储类型PFS：并行存储PFSBOS：对象存储BOS |
| storageInstance | String | 存储实例 |
| importFormat | String | 导入格式FILE：文件FOLDER：文件夹 |
| description | String | 描述 |
| owner | String | 所有者 |
| ownerName | String | 所有者名称 |
| visibilityScope | String | 可见范围ALL_PEOPLE：所有人可见ONLY_OWNER：仅所有者可读写USER_GROUP：指定范围可用 |
| visibilityUser | List<PermissionEntry> | 用户权限列表[{"id": "xxx", "name": "xxx", "permission": "r"}, {"id": "yyy", "name": "xxx", "permission": "rw"}]仅对管理员或Owner返回此属性 |
| visibilityGroup | List<PermissionEntry> | 用户组权限列表[{"id": "xxx", "name": "xxx", "permission": "r"}, {"id": "yyy", "name": "xxx", "permission": "rw"}]仅对管理员或Owner返回此属性 |
| permission | String | 当前用户拥有的读写权限：r：只读rw：读写 |
| latestVersionId | String | 最新版本ID |
| latestVersion | String | 最新版本号 |
| latestVersionEntry | DatasetVersionEntry | 最新版本相关信息 |
| createdAt | String | 创建时间 |
| updatedAt | String | 更新时间 |
请求示例
无。
响应示例
JSON
1{
2 "requestId": "b44d5dc7-d987-495c-90cb-de635f508ba7",
3 "id": "ds-iIkcJJZp",
4 "name": "my-dataset-1",
5 "storageType": "BOS",
6 "storageInstance": "bucket1",
7 "importFormat": "FOLDER",
8 "description": "my dataset",
9 "owner": "d1a5cf0143be4de9911342051106f70f",
10 "ownerName": "zhangsan",
11 "visibilityScope": "ALL_PEOPLE",
12 "permission": "rw",
13 "latestVersionId": "ds-gUgkU83Z",
14 "latestVersion": "1",
15 "latestVersionEntry": {
16 "requestId": "b44d5dc7-d987-495c-90cb-de635f508ba7",
17 "id": "ds-gUgkU83Z",
18 "version": "1",
19 "description": "dataset first version",
20 "storagePath": "/path/to/dir",
21 "mountPath": "/mnt/datasets/test1",
22 "createUser": "eca97e148cb74e9683d7b7240829d1ff",
23 "createUserName": "root",
24 "createdAt": "2025-06-11T00:36:08Z",
25 "updatedAt": "2025-06-11T01:18:29Z"
26 },
27 "createdAt": "2025-06-11T00:36:08Z",
28 "updatedAt": "2025-06-11T01:18:29Z"
29}