查询数据集版本详情
功能介绍
查询数据集版本详情。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v2/{project_id}/datasets/{dataset_id}/versions/{version_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
dataset_id |
是 |
String |
数据集ID。 |
project_id |
是 |
String |
用户项目ID。获取方法请参见获取项目ID和名称。 |
version_id |
是 |
String |
数据集版本ID。 |
请求参数
无
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
add_sample_count |
Integer |
新增样本数量。 |
analysis_cache_path |
String |
特征分析的缓存路径。 |
analysis_status |
Integer |
特征分析任务的当前状态。可选值如下:
|
analysis_task_id |
String |
特征分析的任务ID。 |
annotated_sample_count |
Integer |
版本已标注样本的数量。 |
annotated_sub_sample_count |
Integer |
已标注的子样本数量。 |
clear_hard_property |
Boolean |
发布时是否清空难例属性。可选值如下:
|
code |
String |
旋转裁剪等预处理任务的状态码。 |
create_time |
Long |
版本创建时间。 |
crop |
Boolean |
是否对图片进行裁剪,只对标注框形状为bndbox的物体检测数据集有效。可选值如下:
|
crop_path |
String |
裁剪后的文件存放路径。 |
crop_rotate_cache_path |
String |
旋转裁剪任务执行的临时目录。 |
data_analysis |
Map<String,Object> |
特征分析结果,json格式。 |
data_path |
String |
数据保存路径。 |
data_statistics |
Map<String,Object> |
数据集的样本统计信息,包括样本元信息的统计,json格式。 |
data_validate |
Boolean |
发布前数据是否经过校验算法校验。可选值如下:
|
deleted_sample_count |
Integer |
已删除的样本数量。 |
deletion_stats |
Map<String,Integer> |
删除原因统计信息。 |
description |
String |
版本描述信息。 |
export_images |
Boolean |
发布时是否导出图片到版本输出目录。可选值如下:
|
extract_serial_number |
Boolean |
发布时是否需要解析子样本序号,用于医疗数据集。可选值如下:
|
include_dataset_data |
Boolean |
发布时是否包含数据集源数据。可选值如下:
|
is_current |
Boolean |
是否为数据集当前版本。可选值如下:
|
label_stats |
Array of LabelStats objects |
发布版本的各标签统计信息列表。 |
label_type |
String |
发布版本的标签类型。可选值如下:
|
manifest_cache_input_path |
String |
版本发布时的manifest文件缓存输入路径。 |
manifest_path |
String |
版本发布的manifest文件保存路径。 |
message |
String |
发布时记录的任务信息(如:错误信息等)。 |
modified_sample_count |
Integer |
已修改的样本数量。 |
previous_annotated_sample_count |
Integer |
父版本的已标注样本数量。 |
previous_total_sample_count |
Integer |
父版本的样本总数。 |
previous_version_id |
String |
父版本ID。 |
processor_task_id |
String |
旋转裁剪等预处理任务ID。 |
processor_task_status |
Integer |
旋转裁剪等预处理任务状态。当前可选值如下:
|
remove_sample_usage |
Boolean |
发布时是否清除数据集已有的usage信息。可选值如下:
|
rotate |
Boolean |
是否对图片进行旋转。可选值如下:
|
rotate_path |
String |
旋转后的文件存放路径。 |
sample_state |
String |
样本状态。可选样本状态如下:
|
start_processor_task |
Boolean |
发布时是否启动数据分析任务。可选值如下:
|
status |
Integer |
数据集版本状态。可选值如下:
|
tags |
Array of strings |
版本关键标识列表,标注任务发布版本时将标注类型作为默认标签。如:["图片","物体检测"]。 |
task_type |
Integer |
发布版本的标注任务类型,同数据集类型。 |
total_sample_count |
Integer |
版本样本总数。 |
total_sub_sample_count |
Integer |
从父样本生成的子样本总数。 |
train_evaluate_sample_ratio |
String |
发布版本时切分训练验证比例,默认为1.00,即全部分为训练集。 |
update_time |
Long |
版本更新时间。 |
version_format |
String |
数据集版本格式。可选值如下:
|
version_id |
String |
数据集版本ID。 |
version_name |
String |
数据集版本名称。 |
with_column_header |
Boolean |
发布的CSV文件的第一行是否为列名,对于表格数据集有效。可选值如下:
|
参数 |
参数类型 |
描述 |
---|---|---|
attributes |
Array of LabelAttribute objects |
标签的多维度属性,如标签为“音乐”,可能包含属性“风格”、“歌手”等。 |
count |
Integer |
该标签的打标数量。 |
name |
String |
标签名称。 |
property |
LabelProperty object |
标签基本属性键值对,如颜色、快捷键等。 |
sample_count |
Integer |
包含该标签的样本数量。 |
type |
Integer |
标签类型。可选值如下:
|
参数 |
参数类型 |
描述 |
---|---|---|
default_value |
String |
标签属性默认值。 |
id |
String |
标签属性ID。可通过调用标签列表查询。 |
name |
String |
标签属性名称。不能超过64个字符,不能包含字符!<>=&"'。 |
type |
String |
标签属性类型。可选值如下:
|
values |
Array of LabelAttributeValue objects |
标签属性值列表。 |
参数 |
参数类型 |
描述 |
---|---|---|
@modelarts:color |
String |
内置属性:标签展示的颜色,为色彩的16进制代码,默认为空。例如:“#FFFFF0”。 |
@modelarts:default_shape |
String |
内置属性:物体检测标签的默认形状(物体检测标签专用属性),默认为空。可选值如下:
|
@modelarts:from_type |
String |
内置属性:三元组关系标签的起始实体类型,创建关系标签时必须指定,该参数仅文本三元组数据集使用。 |
@modelarts:rename_to |
String |
内置属性:重命名后的标签名。 |
@modelarts:shortcut |
String |
内置属性:标签快捷键,默认为空。例如:“D”。 |
@modelarts:to_type |
String |
内置属性:三元组关系标签的指向实体类型,创建关系标签时必须指定,该参数仅文本三元组数据集使用。 |
请求示例
查询数据集版本详情
GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/versions/{version_id}
响应示例
状态码: 200
OK
{ "version_id" : "eSOKEQaXhKzxN00WKoV", "version_name" : "V002", "version_format" : "Default", "previous_version_id" : "vlGvUqOcxxGPIB0ugeE", "status" : 1, "create_time" : 1605691027084, "total_sample_count" : 10, "annotated_sample_count" : 10, "total_sub_sample_count" : 0, "annotated_sub_sample_count" : 0, "manifest_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/annotation/V002/V002.manifest", "data_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/annotation/V002/data/", "is_current" : true, "analysis_status" : 3, "train_evaluate_sample_ratio" : "0.9999", "remove_sample_usage" : false, "export_images" : false, "description" : "", "label_stats" : [ { "name" : "Rabbits", "type" : 0, "property" : { "@modelarts:color" : "#3399ff" }, "count" : 5, "sample_count" : 5 }, { "name" : "Bees", "type" : 0, "property" : { "@modelarts:color" : "#3399ff" }, "count" : 5, "sample_count" : 5 } ], "label_type" : "single", "task_type" : 0, "extract_serial_number" : false }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not Found |
错误码
请参见错误码。