获取数据集版本列表
更新时间：2025-06-18
接口描述
获取数据集版本列表。
权限说明
鉴权认证机制的详细内容请参见鉴权认证。
请求结构
Bash
1GET ?action=DescribeDatasetVersions&datasetId=xxx&pageNumber=xxx&pageSize=xxx
2HTTP/1.1
3Host: aihc.bj.baidubce.com
4Authorization: authorization string
5version: v2请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 参数描述 |
|---|---|---|---|---|
| datasetId | String | 是 | Query参数 | 数据集ID |
| pageNumber | Integer | 否 | Query参数 | 请求分页参数，表示第几页，默认值为1 |
| pageSize | Integer | 否 | Query参数 | 单页结果数，不传递该参数默认返回全部 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| totalCount | Integer | 数据集版本总数 |
| versions | List<DatasetVersionEntry> | 数据集版本列表 |
请求示例
无。
响应示例
JSON
1{
2 "requestId": "f21efb29-8c93-4090-b8fc-82e2d21997c7",
3 "totalCount": 2,
4 "versions": [
5 {
6 "id": "ds-1Wi75n2k",
7 "version": "2",
8 "description": "new version",
9 "storagePath": "/path/to/version2",
10 "mountPath": "/mnt/datasets/my-dataset-1/v2",
11 "createUser": "eca97e148cb74e9683d7b7240829d1ff",
12 "createUserName": "root",
13 "createdAt": "2025-06-11T01:40:20Z",
14 "updatedAt": "2025-06-11T01:40:20Z"
15 },
16 {
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 ]
28}