# 查询标注团队列表
#### 功能介绍
查询标注团队列表。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ModelArts/doc?api=ListWorkforces)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
GET /v2/{project_id}/workforces
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                               |
|:---|:---|:---|:---|
| project_id | 是    | String | 用户项目ID。获取方法请参见[获取项目ID和名称](https://support.huaweicloud.com/api-modelarts/modelarts_03_0147.html)。 |
表2Query参数 
| 参数                | 是否必选 | 参数类型    | 描述                                                                     |
|:---|:---|:---|:---|
| 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 | 分页查询到的标注团队列表。 |
   
 表4Workforce 
| 参数             | 参数类型    | 描述                                           |
|:---|:---|:---|
| 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    |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0095.html)。