文档首页/ 自动驾驶云服务 Octopus/ API参考/ API/ 数据集版本/ 获取数据集版本列表
更新时间：2025-05-14 GMT+08:00
查看PDF
分享

获取数据集版本列表

功能介绍

获取数据集版本列表

URI

GET /v1.0/{project_id}/common/datasets/{dataset_id}/versions

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目id，获取方法请参见获取项目ID

dataset_id

是

String

数据集id
表2 Query参数

参数

是否必选

参数类型

描述

name

否

String

根据名称模糊查询

statuses

否

Array of strings

根据数据集版本状态筛选

order

否

String

查询结果的排序方式

offset

否

Integer

查询偏移量

limit

否

Integer

返回个数上限

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

payload

LabelDatasetVersionListPayload object

实际返回信息

meta_info

MetaInfo object

元数据
表5 LabelDatasetVersionListPayload

参数

参数类型

描述

page_info

PageInfo object

分页信息

list

Array of LabelDatasetVersionListVO objects

版本列表
表6 PageInfo

参数

参数类型

描述

total

Long

资源总数

offset

Long

查询偏移量

limit

Long

返回个数上限
表7 LabelDatasetVersionListVO

参数

参数类型

描述

id

String

id

label_dataset_id

String

数据集id

tags

Array of strings

标签

custom_attributes

Array of strings

自定义属性，格式形式"key:value"

label_names

Array of strings

标注物名

name

String

名称

batch_task_id

String

批次任务id

label_meta_names

Array of strings

标注物名

label_format

String

标注格式

status

String

状态

frame_num

String

帧文件数量

frame_size

String

帧文件大小，包含单位

label_count

String

标志物数量

custom_image

String

自定义镜像

command

String

脚本路徑

description

String

描述

project_id

String

项目id

workspace

String

工作空间id

create_at

String

创建时间，UTC标准时间毫秒时间戳

update_at

String

修改时间，UTC标准时间毫秒时间戳

upload_id

String

上传id

agreement_confirm

Boolean

隐私声明同意

source_version_id

String

子集的源数据集版本ID

has_finished

Boolean

已经结束，该数据集下没有非终止状态下的版本表示结束，成功或失败表示终止状态

file_size

String

文件大小，带单位
表8 MetaInfo

参数

参数类型

描述

current_time

String

请求时间，UTC时间格式，时间为UTC标准时间

请求示例

获取数据集版本列表

GET https://{endpoint}/v1.0/{project_id}/common/datasets/61a22ebc-49b3-40b5-b16f-ab9aebd2b231/versions?offset=0&limit=10

响应示例

状态码：200

查询成功

获取数据集版本列表

{
  "meta_info" : {
    "current_time" : "2024-01-02T02:04:22Z"
  },
  "payload" : {
    "list" : [ {
      "id" : "102575d5-cf89-4aca-b856-0d39ae2a69c5",
      "label_dataset_id" : "61a22ebc-49b3-40b5-b16f-ab9aebd2b231",
      "name" : "V1",
      "label_format" : "OCTOPUS",
      "status" : "SUCCESS",
      "frame_num" : 100,
      "frame_size" : 47518529,
      "label_count" : 0,
      "project_id" : "64d37c8f25af4277a1ff4ee9772687bf",
      "workspace_id" : 0,
      "create_at" : 1701393989718,
      "update_at" : 1701394037579,
      "has_finished" : true,
      "file_size" : "45.32MB",
      "custom_image" : "10293:1",
      "command" : "command",
      "description" : "描述"
    } ],
    "page_info" : {
      "total" : 1,
      "offset" : 0,
      "limit" : 10
    }
  }
}

状态码

状态码

描述

200

查询成功

400

参数校验失败

500

系统内部错误

错误码

请参见错误码。

父主题： 数据集版本

相关文档