调用ListDatasetVersions查询数据集版本列表-大数据开发治理平台 DataWorks-阿里云-大数据开发治理平台 DataWorks(DataWorks)-阿里云帮助中心

查询给定数据集的版本列表。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
DatasetId	string	是	数据集 ID	dataworks-dataset:3pXXXb8o0ngr07njhps1
CreatorId	string	否	创建者 ID	12103XXX46492139
SortBy	string	否	排序字段，默认为 VersionNumber（版本号）枚举值： ModifyTime：修改时间。 CreateTime：创建时间。 VersionNumber：版本号。	CreateTime
Order	string	否	排序方向，默认为 Desc（降序）枚举值： Asc：升序。 Desc：降序。	Desc
PageNumber	integer	否	分页页码，默认为 1	1
PageSize	integer	否	分页大小，默认为 10，最大 100	10

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	RequestId	E25887B7-579C-54A5-9C4F-83A0DE367XXX
Success	boolean	请求是否成功	true
PagingInfo	object	分页信息
TotalCount	long	总数	100
PageNumber	integer	分页页码	1
PageSize	integer	分页大小	10
DatasetVersions	array	数据集版本列表
DatasetVersions	DatasetVersion	数据集版本

示例

正常返回示例

JSON格式

{
  "RequestId": "E25887B7-579C-54A5-9C4F-83A0DE367XXX",
  "Success": true,
  "PagingInfo": {
    "TotalCount": 100,
    "PageNumber": 1,
    "PageSize": 10,
    "DatasetVersions": [
      {
        "Id": "dataworks-datasetVersion:0gfxxxjx155usz3hrv:1",
        "DatasetId": "dataworks-datasetVersion:0gfxxxjx155usz3hrv",
        "Comment": "初始版本",
        "CreatorId": "17815XXX61016173",
        "VersionNumber": 1,
        "StorageType": "OSS",
        "Url": "oss://test-oss-bucket/test_dir/",
        "MountPath": "/mnt/data",
        "CreateTime": 1736756055000,
        "ModifyTime": 1736756055000,
        "Labels": [
          {
            "Key": "key1",
            "Value": "value1"
          }
        ],
        "ImportInfo": {
          "key": "None"
        }
      }
    ]
  }
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2025-12-04	新增 OpenAPI	查看变更详情