查询数据集列表
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
polardb:DescribeAIDBClusterDatasets |
list |
*全部资源
|
无 | 无 |
请求语法
POST HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
否 |
地域 ID。 |
cn-beijing |
| DBClusterId |
string |
否 |
AI 模型服务的 PolarDB 数据库实例 ID |
pc-2ze88*** |
| DatasetType |
string |
否 |
数据集的类型，取值如下：
|
train |
| TrainMode |
string |
否 |
数据集应对的训练模式，取值如下：
|
grpo |
| ContinuationToken |
string |
否 |
本次初始 token，查询列表时不生效 |
EFSDF-DF-*** |
| PageSize |
string |
否 |
每页记录数，取值为 30、50 或 100。 默认值为 30。 |
30 |
| PageNumber |
string |
否 |
查询页码，默认值为 1。 |
1 |
| DatasetId |
string |
否 |
数据集 ID |
pds-2ze88*** |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
Id of the request |
2921D843-433A-5FB3-A03B-4EC093B219F8 |
| ContinuationToken |
string |
如果请求中指定了 ContinuationToken 参数，则会在返回的响应中包含 ContinuationToken 元素。 |
EFSDF-DF-*** |
| RelativeDBClusterId |
string |
数据库管理服务 ID |
pc-2ze88*** |
| DatasetType |
string |
数据集的类型，取值如下：
|
train |
| DatasetMode |
string |
数据集应对的训练模式，取值如下：
|
stf |
| NextContinuationToken |
string |
下次列举文件的 ContinuationToken。 |
EFSDF-DF-*** |
| IsTruncated |
boolean |
是否还有后续数据集，取值如下：
|
true |
| TotalCount |
string |
总记录数，仅查询列表时返回 |
6 |
| PageSize |
string |
页大小 |
30 |
| Datasets |
array<object> |
数据集。 |
|
|
object |
数据集。 |
||
| FileName |
string |
文件名称 |
train-***.json |
| Path |
string |
数据集路径 |
polardb_ai/datasets/train/sft/dataset01/train-***.json |
| BucketName |
string |
所属 Bucket |
pcs-2ze22***-q7*** |
| StorageType |
string |
存储类型，取值：
|
Standard |
| Capacity |
string |
文件大小 |
2845904 |
| LastModified |
string |
更新时间 |
2025-11-06T06:50:43Z |
| CreationTime |
string |
创建时间 |
2025-11-06T06:50:43Z |
| DatasetId |
string |
数据集 ID |
pds-2ze88*** |
| DatasetType |
string |
数据集的类型，取值如下：
|
train |
| TrainMode |
string |
数据集应对的训练模式，取值如下：
|
stf |
| TotalRecords |
string |
总记录数。 |
6 |
| PageNumber |
string |
页码。 |
1 |
| DatasetId |
string |
数据集 ID |
pds-2ze88*** |
| DataServiceId |
string |
数据集管理服务实例 ID |
pcs-2zeei*** |
| FileCount |
string |
文件总数 |
6 |
示例
正常返回示例
JSON格式
{
"RequestId": "2921D843-433A-5FB3-A03B-4EC093B219F8",
"ContinuationToken": "EFSDF-DF-***",
"RelativeDBClusterId": "pc-2ze88***",
"DatasetType": "train",
"DatasetMode": "stf",
"NextContinuationToken": "EFSDF-DF-***\n",
"IsTruncated": true,
"TotalCount": "6",
"PageSize": "30",
"Datasets": [
{
"FileName": "train-***.json",
"Path": "polardb_ai/datasets/train/sft/dataset01/train-***.json",
"BucketName": "pcs-2ze22***-q7***",
"StorageType": "Standard\n",
"Capacity": "2845904",
"LastModified": "2025-11-06T06:50:43Z",
"CreationTime": "2025-11-06T06:50:43Z",
"DatasetId": "pds-2ze88***",
"DatasetType": "train",
"TrainMode": "stf"
}
],
"TotalRecords": "6",
"PageNumber": "1",
"DatasetId": "pds-2ze88***",
"DataServiceId": "pcs-2zeei***",
"FileCount": "6"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。