获取数据集详情-GetDataSetsDetails

功能介绍

获取数据集详情

URI

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

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目id，获取方法请参见获取项目ID
dataset_id	是	String	数据集id

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
payload	GetLabelDatasetVoPayload object	实际返回信息
meta_info	MetaInfo object	元数据

表4 GetLabelDatasetVoPayload
参数	参数类型	描述
item	LabelDatasetDetailVO object	数据集信息

表5 LabelDatasetDetailVO
参数	参数类型	描述
id	String	id
name	String	名称
description	String	描述
data_type	String	数据类型
dataset_form	String	数据集形式
source_dataset_id	String	子集的源数据集ID
latest_version	Integer	最新版本
data_source	String	数据来源
owner	String	数据集类型
frame_num	Long	文件数
frame_size	Long	数据集下版本帧文件总大小，单位字节
project_id	String	项目id
workspace_id	String	工作空间id
label_format	String	标注格式
label_count	Long	标注物数量
label_names	Array of strings	所有标注物名称
create_at	Long	创建时间，UTC标准时间毫秒时间戳
update_at	Long	修改时间，UTC标准时间毫秒时间戳
label_taged	Boolean	标注数据集tag，已标注是true
data_source_info	DataSourceInfoList object	数据相关信息
tags	Array of strings	标签
custom_attributes	Array of strings	自定义属性，格式形如"key:value"
version_count	Integer	版本数量
has_finished	Boolean	是否结束，该数据集下没有非终止状态下的版本表示结束，成功或失败表示终止状态
version_success_count	Integer	数据集下状态为成功的版本数量位
source_dataset_name	String	源数据集name

表6 DataSourceInfoList
参数	参数类型	描述
label_project_package_id	String	任务项目包ID
label_project_package_name	String	任务项目包名称
batch_task_ids	Array of strings	批次任务ID
data_warehouse_id	String	通用存储ID
raw_data_ids	Array of strings	原始数据包ID
data_process_task_ids	Array of strings	处理任务ID

表7 MetaInfo
参数	参数类型	描述
current_time	String	请求时间，UTC时间格式，时间为UTC标准时间

请求示例

获取数据集详情

GET https://{endpoint}/v1.0/{project_id}/common/datasets/61a22ebc-49b3-40b5-b16f-ab9aebd2b231

响应示例

状态码：200

查询成功

获取数据集详情

{
  "meta_info" : {
    "current_time" : "2024-01-02T02:04:22Z"
  },
  "payload" : {
    "item" : {
      "id" : "61a22ebc-49b3-40b5-b16f-ab9aebd2b231",
      "name" : "数据集1",
      "description" : "测试数据集",
      "data_type" : "IMAGE",
      "latest_version" : 0,
      "data_source" : "HOUSE",
      "frame_num" : 0,
      "frame_size" : 0,
      "project_id" : "64d37c8f25af4277a1ff4ee9772687bf",
      "workspace_id" : 0,
      "label_format" : "OCTOPUS",
      "label_count" : 0,
      "label_taged" : false,
      "create_at" : 1701403312027,
      "update_at" : 1701403312027,
      "data_source_info" : {
        "data_warehouse_id" : "ee9784a5-dde5-4a47-a006-fac074c5bee8"
      },
      "version_count" : 0,
      "has_finished" : true,
      "version_success_count" : 0,
      "dataset_form" : "DATASET"
    }
  }
}