调用ListDatasetVersions接口获取数据集版本列表-人工智能平台 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 : ASC DESC : DESC	ASC
LabelKeys	string	否	数据集标签，用于过滤数据集列表。标签 Key 或 Value 中，有指定字符串的，都会被过滤出来。	key1,key2
LabelValues	string	否	数据集标签，用于过滤数据集列表。标签 Key 或 Value 中，有指定字符串的，都会被过滤出来。	value1,value2
Properties	string	否	数据集属性，支持以下取值： DIRECTORY：文件夹。 FILE：文件。枚举值： DIRECTORY : DIRECTORY FILE : 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	数据集版本

示例

正常返回示例

JSON格式

{
  "RequestId": "0648C5BB-68D0-54D2-92A5-607135B8806B",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 5,
  "DatasetVersions": [
    {
      "VersionName": "v1",
      "GmtCreateTime": "2021-01-21T17:12:35.232Z",
      "GmtModifiedTime": "2021-01-21T17:12:35.232Z",
      "Property": "FILE",
      "DataSourceType": "OSS",
      "Uri": "OSS://xxx",
      "Labels": [
        {
          "Key": "env",
          "Value": "test"
        }
      ],
      "Options": "{\n  \"mountPath\": \"/mnt/data/\"\n}",
      "SourceType": "USER",
      "Description": "base model v1",
      "SourceId": "d-65mrsr5fub4u74lej3",
      "DataCount": 10000,
      "DataSize": 10000,
      "MountAccess": "RO",
      "ImportInfo": "{\n    \"region\": \"cn-wulanchabu\",\n    \"fileSystemId\": \"bmcpfs-xxxxxxxxxxx\",\n    \"path\": \"/mnt\",\n    \"mountTarget\": \"cpfs-xxxxxxxxxxxx-vpc-gacs9f.cn-wulanchabu.cpfs.aliyuncs.com\",\n    \"isVpcMount\": true\n}"
    }
  ]
}

错误码

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

变更历史

更多信息，参考变更详情。