文档首页/魔坊（ModelArts）模型训推平台/API参考/历史API/数据管理（旧版）/查询标注团队列表
更新时间：2025-06-30 GMT+08:00
查看PDF
分享

查询标注团队列表

功能介绍

查询标注团队列表。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

GET /v2/{project_id}/workforces

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

用户项目ID。获取方法请参见获取项目ID和名称。

表2 Query参数

参数

是否必选

参数类型

描述

limit

否

Integer

指定每一页返回的最大条目数，取值范围[1,100]，默认为10。

offset

否

Integer

分页列表的起始页，默认为0。

order

否

String

指定查询的排序顺序。可选值如下：

  • asc：递增排序

  • desc：递减排序（默认值）

search_content

否

String

模糊匹配名称，默认为空。

sort_by

否

String

指定查询的排序方式。可选值如下：

  • create_time：按创建时间排序（默认值）

  • workforce_name：按标注团队名称排序

workforce_task_id

否

String

团队标注任务ID。

请求参数

无

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

total_number

Integer

标注团队总数。

workforces

Array of Workforce objects

分页查询到的标注团队列表。

表4 Workforce

参数

参数类型

描述

create_time

Long

标注团队的创建时间。

description

String

标注团队的描述。

update_time

Long

标注团队的更新时间。

worker_count

Integer

标注团队的成员总数。

workforce_id

String

标注团队ID。

workforce_name

String

标注团队名称。

workspace_id

String

工作空间ID。未创建工作空间时默认值为“0”，存在创建并使用的工作空间，以实际取值为准。

请求示例

查询标注团队列表

GET https://{endpoint}/v2/{project_id}/workforces

响应示例

状态码： 200

OK

{
  "total_number" : 2,
  "workforces" : [ {
    "workforce_id" : "ZUH8gqkjuaib8pxkDdz",
    "workforce_name" : "team-123",
    "description" : "my team",
    "worker_count" : 0,
    "create_time" : 1606354772548,
    "update_time" : 1606354772548
  }, {
    "workforce_id" : "3Ry04NsqvEybuWYLDvC",
    "workforce_name" : "team-170a",
    "description" : "",
    "worker_count" : 1,
    "create_time" : 1604644946891,
    "update_time" : 1606238678626
  } ]
}

状态码

状态码

描述

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码。