文档首页/ AI开发平台ModelArts/ API参考/ 历史API/ 数据管理（旧版）/ 查询标注团队的成员列表
更新时间：2025-06-30 GMT+08:00
查看PDF
分享

查询标注团队的成员列表

功能介绍

查询标注团队的成员列表。

调试

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

URI

GET /v2/{project_id}/workforces/{workforce_id}/workers

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

workforce_id

是

String

标注团队ID。
表2 Query参数

参数

是否必选

参数类型

描述

limit

否

Integer

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

offset

否

Integer

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

order

否

String

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

  • asc：递增排序

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

sort_by

否

String

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

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

  • email：按邮件排序

请求参数

无

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

total_number

Integer

标注团队成员总数。

workers

Array of Worker objects

分页查询到的标注团队成员列表。
表4 Worker

参数

参数类型

描述

create_time

Long

创建时间。

description

String

标注成员描述，长度为0-256位，不能包含^!<>=&"'特殊字符。

email

String

标注成员邮箱。

role

Integer

角色。可选值如下：

  • 0：打标者

  • 1：审核者

  • 2：团队管理者

  • 3：数据集拥有者

status

Integer

标注成员的当前登录状态。可选值如下：

  • 0：未发送邀请邮件

  • 1：已发送邀请邮件但未登录

  • 2：已登录

  • 3：标注成员已删除

update_time

Long

更新时间。

worker_id

String

标注成员ID。

workforce_id

String

所属标注团队ID。

请求示例

查询标注团队的成员列表

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

响应示例

状态码： 200

OK

{
  "total_number" : 3,
  "workers" : [ {
    "email" : "xxx@xxx.com",
    "worker_id" : "b1e4054407ecb36a7bcde70f52ba37f2",
    "workforce_id" : "gyb7IaAvkLc5IhEY2dv",
    "status" : 0,
    "role" : 2,
    "description" : "",
    "create_time" : 1606356324223,
    "update_time" : 1606356324223
  }, {
    "email" : "xxx@xxx.com",
    "worker_id" : "8c15ad080d3eabad14037b4eb00d6a6f",
    "workforce_id" : "gyb7IaAvkLc5IhEY2dv",
    "status" : 0,
    "role" : 0,
    "description" : "",
    "create_time" : 1591783804629,
    "update_time" : 1591783804629
  }, {
    "email" : "xxx@xxx.com",
    "worker_id" : "2880f38d660dd68ca6ab578b5a1d9558",
    "workforce_id" : "gyb7IaAvkLc5IhEY2dv",
    "status" : 0,
    "role" : 0,
    "description" : "",
    "create_time" : 1575104629439,
    "update_time" : 1575104629439
  } ]
}

状态码

状态码

描述

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码。

相关文档