ListDatasetVersions - 获取数据集版本列表_人工智能平台 PAI(PAI)-阿里云帮助中心

获取数据集版本列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
paidataset:ListDatasetVersions	list	全部资源 ``	无	无

请求语法

GET /api/v1/datasets/{DatasetId}/versions HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
DatasetId	string	是	数据集 ID。如何获取数据集 ID，详情请参见 ListDatasets 。	d-rbvg5wz****c9ks92
PageNumber	integer	是	数据集列表的页码。起始值为 1，默认为 1。	1
PageSize	integer	是	分页查询时设置的每页行数。默认为 10。	10
Order	string	否	分页查询时，对指定的排序字段进行升序或降序。默认值为 ASC。 ASC：升序。 DESC：降序。	ASC
LabelKeys	string	否	数据集标签，用于过滤数据集列表。标签 Key 或 Value 中，有指定字符串的，都会被过滤出来。	key1,key2
LabelValues	string	否	数据集标签，用于过滤数据集列表。标签 Key 或 Value 中，有指定字符串的，都会被过滤出来。	value1,value2
Properties	string	否	数据集属性，支持以下取值： DIRECTORY：文件夹。 FILE：文件。	DIRECTORY
SourceTypes	string	否	来源类型，支持以下取值： PAI-PUBLIC-DATASET：PAI 公共数据集。 ITAG：iTAG 模块标注结果生成的数据集。 USER：用户注册的数据集。枚举值： PAI_PUBLIC_DATASET：PAI_PUBLIC_DATASET。 ITAG：ITAG。 USER：USER。	USER
SourceId	string	否	数据来源 ID。当 SourceTypes 为 USER 时，SourceId 支持自定义。当 SourceTypes 为 ITAG 时，即 iTAG 模块标注结果生成的数据集时，SourceId 为 ITAG 的任务 ID。当 SourceTypes 为 PAI_PUBLIC_DATASET 时，即使用 PAI 公共数据集创建的数据集时，SourceId 默认为空。	d-a0xbe5n03bhqof46ce
SortBy	string	否	分页查询时的排序字段，默认使用 GmtCreateTime。取值如下。 GmtCreateTime（默认值）：按创建时间。 GmtModifiedTime：按修改时间。 SourceType DataSourceType Property DataSize DataCount 枚举值： SourceType：SourceType。 DataSourceType：DataSourceType。 DataSize：DataSize。 DataCount：DataCount。 Property：Property。 GmtCreateTime：GmtCreateTime。 GmtModifiedTime：GmtModifiedTime。 DatasetId：DatasetId。	GmtCreateTime

返回参数

名称	类型	描述	示例值
	object	返回体
RequestId	string	Id of the request	0648C5BB-68D0-54D2-92A5-607135B8806B
PageNumber	integer	当前页码。	1
PageSize	integer	当前页大小。	10
TotalCount	integer	符合过滤条件的资源数量。	5
DatasetVersions	array	数据集版本列表
DatasetVersion	DatasetVersion	数据集版本

示例

正常返回示例

JSON格式

{
  "RequestId": "0648C5BB-68D0-54D2-92A5-607135B8806B",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 5,
  "DatasetVersions": [
    {
      "VersionName": "v1",
      "GmtCreateTime": "",
      "GmtModifiedTime": "",
      "Property": "FILE",
      "DataSourceType": "OSS",
      "Uri": "OSS://xxx",
      "Labels": [
        {
          "Key": "env",
          "Value": "test"
        }
      ],
      "Options": "",
      "SourceType": "",
      "Description": "",
      "SourceId": "",
      "DataCount": 0,
      "DataSize": 0
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2024-11-21	OpenAPI 入参发生变更	查看变更详情
2024-10-30	OpenAPI 返回结构发生变更	查看变更详情