查询数据集的团队标注任务列表
功能介绍
查询数据集的团队标注任务列表。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v2/{project_id}/datasets/{dataset_id}/workforce-tasks
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
dataset_id | 是 | String | 数据集ID。 |
project_id | 是 | String | 用户项目ID。获取方法请参见获取项目ID和名称。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
offset | 否 | Integer | 分页列表的起始页,默认为0。 |
limit | 否 | Integer | 指定每一页返回的最大条目数,取值范围[1,1000],默认为1000。 |
请求参数
无
响应参数
状态码: 200
参数 | 参数类型 | 描述 |
|---|---|---|
count | Integer | 团队标注任务总数。 |
tasks | Array of WorkforceTask objects | 分页查询到的团队标注任务列表。 |
参数 | 参数类型 | 描述 |
|---|---|---|
auto_sync_dataset | Boolean | 团队标注任务的标注结果是否自动同步至数据集。可选值如下:
|
check_rate | Double | 团队标注任务验收比例。 |
checking_task_desc | WorkforceSamplingTaskDesc object | 团队标注任务当前验收任务详情。 |
create_time | Long | 标注任务创建时间。 |
dataset_id | String | 数据集ID。 |
description | String | 标注任务描述信息。 |
label_stats | Array of LabelStats objects | 标注任务标签统计信息。 |
pass_rate | Double | 团队标注任务验收通过率。 |
repetition | Integer | 团队标注任务每个样本可以由多少人标注,最少为1。 |
sample_search_conditions | Array of SearchCondition objects | 创建任务时的样本筛选条件。 |
sample_stats | SampleStats object | 标注任务样本统计信息。 |
score | Double | 团队标注任务平均验收审核评分。 |
status | Integer | 团队标注任务状态,可选值如下:
|
synchronize_auto_labeling_data | Boolean | 团队标注任务是否同步智能标注结果。可选值如下:
|
synchronize_data | Boolean | 团队标注任务是否同步更新新增数据。可选值如下:
|
task_id | String | 标注任务ID。 |
task_name | String | 标注任务名称。 |
update_time | Long | 标注任务更新时间。 |
version_id | String | 标注任务关联的数据集版本ID。 |
workforce_stats | WorkforceStats object | 团队标注任务人员统计信息。 |
workforces_config | WorkforcesConfig object | 团队标注任务团队信息:委托团队管理员分配,或指定团队自行分配。 |
参数 | 参数类型 | 描述 |
|---|---|---|
action | Integer | 验收操作。可选值如下:
|
checking_stats | CheckTaskStats object | 验收任务实时验收报告。 |
checking_task_id | String | 当前验收任务ID。 |
overwrite_last_result | Boolean | 验收时若样本已标注,是否使用验收结果覆盖已标注结果。可选值如下:
|
total_stats | CheckTaskStats object | 历史验收任务汇总后的验收报告。 |
参数 | 参数类型 | 描述 |
|---|---|---|
accepted_sample_count | Integer | 通过的样本数目。 |
checked_sample_count | Integer | 已验收的样本数目。 |
pass_rate | Double | 样本的通过率。 |
rejected_sample_count | Integer | 驳回的样本数目。 |
sampled_sample_count | Integer | 抽样的样本数目。 |
sampling_num | Integer | 验收任务的抽样数目。 |
sampling_rate | Double | 验收任务的抽样比例。 |
score | String | 验收评分。 |
task_id | String | 验收任务ID。 |
total_sample_count | Integer | 总的样本数目。 |
total_score | Long | 验收总分。 |
unchecked_sample_count | Integer | 未验收的样本数目。 |
参数 | 参数类型 | 描述 |
|---|---|---|
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 | 内置属性:三元组关系标签的指向实体类型,创建关系标签时必须指定,该参数仅文本三元组数据集使用。 |
参数 | 参数类型 | 描述 |
|---|---|---|
coefficient | String | 根据难度系数筛选。 |
frame_in_video | Integer | 视频中某帧。 |
hard | String | 样本级别是否难例。可选值如下:
|
import_origin | String | 根据数据来源筛选。 |
kvp | String | CT剂量,通过剂量来筛选。 |
label_list | SearchLabels object | 标签搜索条件。 |
labeler | String | 标注人。 |
metadata | SearchProp object | 通过样本属性搜索。 |
parent_sample_id | String | 父样本ID。 |
sample_dir | String | 根据样本所在目录搜索(目录需要以/结尾),只搜索指定目录下的样本,不支持目录递归搜索。 |
sample_name | String | 根据样本名称搜索(含后缀名)。 |
sample_time | String | 样本加入到数据集时,会根据样本在OBS上的最后修改时间(精确到天)建立索引,此处可以根据此时间进行搜索。可选值如下:
|
score | String | 根据置信度筛选。 |
slice_thickness | String | DICOM层厚,通过层厚筛选样本。 |
study_date | String | DICOM扫描时间。 |
time_in_video | String | 视频中某个时间。 |
参数 | 参数类型 | 描述 |
|---|---|---|
labels | Array of SearchLabel objects | 标签搜索条件列表。 |
op | String | 如要搜索多个标签,则op需要有值;如果只搜索一个标签,则无需指定op的值。可选值如下:
|
参数 | 参数类型 | 描述 |
|---|---|---|
name | String | 标签名。 |
op | String | 多个属性之间的操作类型。可选值如下:
|
property | Map<String,Array<String>> | 标签属性,是Object格式,存放任意的键值对;key是属性名称,value是取值列表,如value为null表示不根据值搜索,否则搜索的值满足列表中任意一个即可。 |
type | Integer | 标签类型。可选值如下:
|
参数 | 参数类型 | 描述 |
|---|---|---|
op | String | 多个属性值之间的关系。可选值如下:
|
props | Map<String,Array<String>> | 属性的搜索条件,可以有多个属性条件。 |
参数 | 参数类型 | 描述 |
|---|---|---|
accepted_sample_count | Integer | owner验收通过样本数目。 |
auto_annotation_sample_count | Integer | 智能标注待确认样本数目。 |
deleted_sample_count | Integer | 已删除的样本数目。 |
rejected_sample_count | Integer | owner验收不通过的样本数目。 |
sampled_sample_count | Integer | 待owner验收且被抽样的样本数目。 |
total_sample_count | Integer | 样本总数量。 |
unannotated_sample_count | Integer | 未标注样本数。 |
uncheck_sample_count | Integer | reviewer审核通过待owner验收的样本数目。 |
unreviewed_sample_count | Integer | labeler标注完未被reviewer审核的样本数目。 |
参数 | 参数类型 | 描述 |
|---|---|---|
labeler_count | Integer | 标注人员数量,不能超过100个。 |
reviewer_count | Integer | 审核人员数量,不能超过100个。 |
workforce_count | Integer | 团队数量。 |
参数 | 参数类型 | 描述 |
|---|---|---|
workers | Array of Worker objects | 标注成员列表。 |
workforce_id | String | 标注团队ID。 |
workforce_name | String | 标注团队名称,名称不能包含!<>=&"',长度为0-1024位。 |
请求示例
查询数据集的团队标注任务列表
GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/workforce-tasks 响应示例
状态码: 200
OK
{
"count" : 2,
"tasks" : [ {
"dataset_id" : "WxCREuCkBSAlQr9xrde",
"task_id" : "tY330MHxV9dqIPVaTRM",
"task_name" : "task-cd60",
"status" : 1,
"create_time" : 1606224714358,
"update_time" : 1606224714358,
"repetition" : 1,
"workforces_config" : {
"workforces" : [ {
"workforce_id" : "0PfqwXA8M59pppYBx4k",
"workforce_name" : "team-123",
"workers" : [ {
"email" : "xxx@xxx.com",
"worker_id" : "6db04ae0afb54d7274a2982255516c29",
"role" : 2
}, {
"email" : "xxx@xxx.com",
"worker_id" : "8c15ad080d3eabad14037b4eb00d6a6f",
"role" : 0
} ]
} ]
},
"synchronize_data" : true,
"synchronize_auto_labeling_data" : true,
"workforce_stats" : {
"workforce_count" : 1,
"labeler_count" : 1,
"reviewer_count" : 0
},
"sample_stats" : {
"total_sample_count" : 309,
"unannotated_sample_count" : 308,
"unreviewed_sample_count" : 0,
"uncheck_sample_count" : 1,
"sampled_sample_count" : 0,
"rejected_sample_count" : 0,
"accepted_sample_count" : 0,
"auto_annotation_sample_count" : 0
},
"auto_sync_dataset" : true
}, {
"dataset_id" : "WxCREuCkBSAlQr9xrde",
"task_id" : "iYZx7gScPUozOXner9k",
"task_name" : "task-e63f",
"status" : 1,
"create_time" : 1606184400278,
"update_time" : 1606184400278,
"repetition" : 1,
"workforces_config" : {
"workforces" : [ {
"workforce_id" : "q3ZFSwORu1ztKljDLYQ",
"workforce_name" : "modelarts-team",
"workers" : [ {
"email" : "xxx@xxx.com",
"worker_id" : "afdda13895bc66322ffbf36ae833bcf0",
"role" : 0
} ]
} ]
},
"synchronize_data" : false,
"synchronize_auto_labeling_data" : false,
"workforce_stats" : {
"workforce_count" : 1,
"labeler_count" : 1,
"reviewer_count" : 0
},
"sample_stats" : {
"total_sample_count" : 317,
"unannotated_sample_count" : 310,
"unreviewed_sample_count" : 0,
"uncheck_sample_count" : 0,
"sampled_sample_count" : 0,
"rejected_sample_count" : 0,
"accepted_sample_count" : 7,
"auto_annotation_sample_count" : 0
},
"checking_task_desc" : {
"checking_task_id" : "onSbri2oqYOmDjDyW17",
"action" : 0,
"overwrite_last_result" : false
},
"auto_sync_dataset" : true
} ]
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
错误码
请参见错误码。

