获取数据集列表
更新时间：2025-06-18
接口描述
获取数据集列表。
权限说明
鉴权认证机制的详细内容请参见鉴权认证。
请求结构
Bash
1GET ?action=DescribeDatasets&keyword=xxx&storageType=xxx&storageInstances=xxx&importFormat=xxx&pageNumber=xxx&pageSize=xxx
2HTTP/1.1
3Host: aihc.bj.baidubce.com
4Authorization: authorization string
5version: v2请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 参数描述 |
|---|---|---|---|---|
| keyword | String | 否 | Query参数 | 名称关键字 |
| storageType | String | 否 | Query参数 | 存储类型PFS：并行存储PFSBOS：对象存储BOS |
| storageInstances | String | 否 | Query参数 | 存储实例列表，英文逗号(,)分隔 |
| importFormat | String | 否 | Query参数 | 导入格式FILE：文件FOLDER：文件夹 |
| pageNumber | Integer | 否 | Query参数 | 请求分页参数，表示第几页，默认值为1 |
| pageSize | Integer | 否 | Query参数 | 单页结果数，不传递该参数默认返回全部 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| totalCount | Integer | 数据集总数 |
| datasets | List<Dataset> | 数据集列表 |
请求示例
无。
响应示例
JSON
1{
2 "requestId": "beafc892-e82c-4d81-8a11-ec275a80995b",
3 "totalCount": 12,
4 "datasets": [
5 {
6 "id": "ds-0jaV0FAF",
7 "name": "develop-dataset-ghco",
8 "storageType": "PFS",
9 "storageInstance": "pfs-7xWeAt",
10 "importFormat": "FOLDER",
11 "owner": "3025f29850b24632bafa8ba7b6849195",
12 "ownerName": "zhangsan",
13 "visibilityScope": "ALL_PEOPLE",
14 "permission": "rw",
15 "latestVersionId": "ds-9V7U45A5",
16 "latestVersion": "1",
17 "createdAt": "2025-06-05T16:40:00Z",
18 "updatedAt": "2025-06-05T16:40:00Z"
19 },
20 {
21 "id": "ds-TXzhsuDR",
22 "name": "develop-dataset-mfee",
23 "storageType": "PFS",
24 "storageInstance": "pfs-7xWeAt",
25 "importFormat": "FOLDER",
26 "owner": "3025f29850b24632bafa8ba7b6849195",
27 "ownerName": "zhangsan",
28 "visibilityScope": "ALL_PEOPLE",
29 "permission": "rw",
30 "latestVersionId": "ds-33xclZz6",
31 "latestVersion": "1",
32 "createdAt": "2025-06-05T09:37:09Z",
33 "updatedAt": "2025-06-05T09:37:09Z"
34 }
35 ]
36}