# 启动团队标注任务
#### 功能介绍
启动团队标注任务。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ModelArts/doc?api=StartWorkforceTask)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
POST /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}
表1路径参数 
| 参数                | 是否必选 | 参数类型   | 描述                                                                                               |
|:---|:---|:---|:---|
| dataset_id        | 是    | String | 数据集ID。                                                                                           |
| project_id        | 是    | String | 用户项目ID。获取方法请参见[获取项目ID和名称](https://support.huaweicloud.com/api-modelarts/modelarts_03_0147.html)。 |
| workforce_task_id | 是    | String | 团队标注任务ID。                                                                                        |
#### 请求参数
表2请求Body参数 
| 参数                | 是否必选 | 参数类型                                                                               | 描述                              |
|:---|:---|:---|:---|
| dataset_id        | 否    | String                                                                             | 数据集ID。                          |
| task_id           | 否    | String                                                                             | 团队标注任务ID。                       |
| workforces_config | 否    | [WorkforcesConfig] object | 团队标注任务团队信息：委托团队管理员分配，或指定团队自行分配。 |
   
 表3WorkforcesConfig 
| 参数         | 是否必选 | 参数类型                                                                                       | 描述           |
|:---|:---|:---|:---|
| agency     | 否    | String                                                                                     | 管理员。         |
| workforces | 否    | Array of [WorkforceConfig] objects | 执行标注任务的团队列表。 |
   
 表4WorkforceConfig 
| 参数             | 是否必选 | 参数类型                                                                     | 描述                                  |
|:---|:---|:---|:---|
| workers        | 否    | Array of [Worker] objects | 标注成员列表。                             |
| workforce_id   | 否    | String                                                                   | 标注团队ID。                             |
| workforce_name | 否    | String                                                                   | 标注团队名称，名称不能包含!\<\>=\&"'，长度为0-1024位。 |
   
 表5Worker 
| 参数           | 是否必选 | 参数类型    | 描述                                                                 |
|:---|:---|:---|:---|
| 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。                                                          |
   
#### 响应参数
无
#### 请求示例
启动团队标注任务
```
{
  "workforces_config" : {
    "workforces" : [ {
      "workforce_id" : "l4u9Hpz2JJ67DNN1Hg9",
      "workers" : [ {
        "email" : "xiaozhang@163.com"
      }, {
        "email" : "xiaoli@163.com"
      } ]
    } ]
  }
}
```
#### 响应示例
**状态码： 200**
OK
```
{ }
```
#### 状态码
| 状态码 | 描述           |
|:---|:---|
| 200 | OK           |
| 401 | Unauthorized |
| 403 | Forbidden    |
| 404 | Not Found    |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0095.html)。