j9九游会登录/ 智果（agentarts）智能体平台/ api参考/ api/ / / 获取评测集版本列表 - listopsdatasetversions
更新时间：2026-07-17 gmt 08:00
查看pdf

获取评测集版本列表 -j9九游会登录

功能介绍

接口用于通过分页方式查询指定数据集下所有已成功发布的历史版本记录，按发布时间倒序排列，为用户提供数据集变更历史。

适用场景：

  • 版本回溯：查看数据集的发布历史，追踪数据集随时间演进的变更记录。

  • 版本差异对比：获取不同版本的id信息，以便后续调取详情接口进行内容或schema的差异化分析。

调用方法

请参见如何调用api。

授权信息

账号根用户具备所有api的调用权限，如果使用账号下的iam用户调用当前api，该iam用户需具备如下身份策略权限，更多的权限说明请参见。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts:dataset:listopsdatasetversions

list

dataset *

g:resourcetag/

-

-

uri

get /v1/ops/datasets/{dataset_id}/versions

表1 路径参数

参数

是否必选

参数类型

描述

dataset_id

是

string

参数解释：

评测集的唯一标识符（id）

约束限制：

由英文、数字、“-”、“_”组成，长度为1到64个字符。

取值范围：

由英文、数字、连字符(-)、下划线(_)组成的1-64位字符串。

默认取值：

无。
表2 query参数

参数

是否必选

参数类型

描述

offset

否

integer

参数解释：

分页查询时的起始偏移量。用于指定从满足条件的第几条记录开始返回，常与limit配合实现翻页功能。

约束限制：

数值范围在0到10000之间。

取值范围：

0到10000。

默认取值：

0。

limit

否

integer

参数解释：

每页返回的记录数量。用于控制单次查询结果集的大小。

约束限制：

数值范围在1到100之间。

取值范围：

1 到100。

默认取值：

10。

请求参数

无

响应参数

状态码：200

表3 响应body参数

参数

参数类型

描述

versions

array of opsversioninfo objects

参数解释：

包含当前分页中评测集版本的简要信息列表。

取值范围：

符合 opsversioninfo 结构定义。

total

integer

参数解释：

当前评测集下已发布版本的总记录数。

取值范围：

0到2147483647。
表4 opsversioninfo

参数

参数类型

描述

id

string

参数解释：

版本的唯一标识符。

取值范围：

符合通用唯一识别码(uuid)标准的字符串。

version

string

参数解释：

用户定义的版本号或标签名。

取值范围：

自定义字符串，如v1.0.0等。

description

string

参数解释：

对该版本变更内容或用途的简要描述。

取值范围：

任意字符串。

item_count

integer

参数解释：

该版本快照中包含的数据条目总数。

取值范围：

0到2147483647。

created_at

string

参数解释：

版本的发布创建时间。

取值范围：

utc时间格式字符串。

请求示例

查询指定评测集下所有已成功发布的历史版本记录

get https://api.example.com/v1/ops/datasets/dcacda233/versions

响应示例

状态码：200

查询成功

{
  "versions" : [ {
    "id" : "550e8400-e29b-41d4-a716-446655440001",
    "version" : "v1",
    "description" : "初始版本",
    "item_count" : 100,
    "created_at" : "2024-01-15t10:30:00z"
  } ],
  "total" : 5
}

状态码

状态码

描述

200

查询成功

错误码

请参见错误码。

父主题：

相关文档

网站地图