# 编辑作业
#### 功能介绍
编辑作业。
#### URI
POST /v3/{project_id}/ai-mgr/deployments/{deployment_id}/task/{task_id}
表1路径参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                                                                          |
|:---|:---|:---|:---|
| deployment_id | 是    | String | 部署ID，从专业版HiLens控制台部署管理[获取部署列表](https://support.huaweicloud.com/api-hilens/getDeploymentListUsingGET.html)获取 |
| project_id    | 是    | String | 项目ID。获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-hilens/hilens_07_0020.html)                        |
| task_id       | 是    | String | 作业ID，从专业版HiLens控制台作业管理[获取作业列表](https://support.huaweicloud.com/api-hilens/listTasksUsingGET.html)获取         |
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                 |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 租户Token。获取方法请参见[获取Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html) |
   
表3请求Body参数 
| 参数          | 是否必选 | 参数类型                                                      | 描述                       |
|:---|:---|:---|:---|
| business    | 否    | String                                                    | 作业动作，创建作业或者是删除作业又或是更新作业等 |
| data        | 是    | [TaskData] object | 作业详情                     |
| description | 否    | String                                                    | 作业描述                     |
| instance_id | 否    | String                                                    | 实例ID，非必选                 |
| name        | 是    | String                                                    | 作业名称                     |
| timestamp   | 否    | String                                                    | 时间戳，非必选                  |
   
 表4TaskData 
| 参数                    | 是否必选 | 参数类型                                                                                    | 描述     |
|:---|:---|:---|:---|
| streams               | 是    | Array of [TaskStream] objects                 | 作业流详情  |
| task_id               | 否    | String                                                                                  | 作业id   |
| start_time_info       | 否    | [StartTimeInfo] object                     | 任务启动信息 |
| source_usage_estimate | 否    | [TaskSourceUsageEstimate] object | 资源消耗   |
   
 表5TaskStream 
| 参数      | 是否必选 | 参数类型                                                                      | 描述     |
|:---|:---|:---|:---|
| common  | 否    | Object                                                                    | 作业参数配置 |
| input   | 是    | [TaskInput] object               | 输入详情   |
| outputs | 是    | Array of [TaskOutputs] objects | 输出详情   |
   
 表6TaskInput 
| 参数   | 是否必选 | 参数类型   | 描述   |
|:---|:---|:---|:---|
| data | 是    | Object | 输入数据 |
| type | 是    | String | 输入类型 |
   
 表7TaskOutputs 
| 参数   | 是否必选 | 参数类型   | 描述   |
|:---|:---|:---|:---|
| data | 是    | Object | 输出数据 |
| type | 是    | String | 输出类型 |
   
 表8StartTimeInfo 
| 参数                | 是否必选 | 参数类型                                                                  | 描述                        |
|:---|:---|:---|:---|
| start_time        | 是    | String                                                                | 任务启动时间                    |
| frequency         | 否    | String                                                                | 任务运行频率（定时任务频率，每天运行还是单次运行） |
| mode              | 否    | String                                                                | 任务运行模式（按时间段运行还是按频率运行）     |
| day_time_frame    | 否    | Array of [TimeFrame] objects | 每天运行时间段                   |
| single_time_frame | 否    | Array of [TimeFrame] objects | 每次运行时间段                   |
   
 表9TimeFrame 
| 参数    | 是否必选 | 参数类型   | 描述     |
|:---|:---|:---|:---|
| start | 是    | String | 任务开始时间 |
| stop  | 是    | String | 任务结束时间 |
   
 表10TaskSourceUsageEstimate 
| 参数     | 是否必选 | 参数类型    | 描述    |
|:---|:---|:---|:---|
| cpu    | 是    | Float   | cpu消耗 |
| memory | 是    | Integer | 内存消耗  |
   
#### 响应参数
**状态码： 200**
表11响应Body参数 
| 参数      | 参数类型   | 描述   |
|:---|:---|:---|
| task_id | String | 作业id |
   
#### 请求示例
更新某个作业
```
POST https://{endpoint}/v3/{project_id}/ai-mgr/deployments/{deployment_id}/task/{task_id}
{
  "business" : "string",
  "data" : {
    "streams" : [ {
      "common" : { },
      "input" : {
        "data" : { },
        "type" : "string"
      },
      "outputs" : [ {
        "data" : { },
        "type" : "string"
      } ]
    } ],
    "task_id" : "string",
    "start_time_info" : {
      "start_time" : "string",
      "frequency" : "string",
      "mode" : "string",
      "day_time_frame" : [ {
        "start" : "string",
        "stop" : "string"
      } ],
      "single_time_frame" : [ {
        "start" : "string",
        "stop" : "string"
      } ]
    }
  },
  "description" : "string",
  "instance_id" : "string",
  "name" : "string",
  "timestamp" : "string"
}
```
#### 响应示例
**状态码： 200**
请求成功
```
{
  "task_id" : "string"
}
```
#### 状态码
| 状态码 | 描述       |
|:---|:---|
| 200 | 请求成功     |
| 401 | 认证不通过    |
| 403 | 拒绝执行请求   |
| 404 | 请求的资源不存在 |
| 500 | 服务器内部错误  |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-hilens/ErrorCode.html)。