# 更新计划任务 - UpdateGroupScheduledTask
#### 功能介绍
更新弹性伸缩计划任务。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/AS/doc?api=UpdateGroupScheduledTask)中调试该接口。
#### URI
PUT /autoscaling-api/v1/{project_id}/scaling-groups/{scaling_group_id}/scheduled-tasks/{scheduled_task_id}
表1参数说明 
| 参数                | 是否必选 | 参数类型   | 描述     |
|:---|:---|:---|:---|
| project_id        | 是    | String | 项目ID   |
| scaling_group_id  | 是    | String | 伸缩组ID  |
| scheduled_task_id | 是    | String | 计划任务ID |
   
#### 请求参数
表2请求参数 
| 参数               | 是否必选 | 参数类型   | 描述                                                |
|:---|:---|:---|:---|
| name             | 否    | String | 计划任务名称                                            |
| scheduled_policy | 否    | Object | 计划任务策略，请参考[表3] |
| instance_number  | 否    | Object | 伸缩组实例数，请参考[表4]  |
   
 表3scheduled_policy字段数据结构说明 
| 参数               | 是否必选 | 参数类型   | 描述                                                                                                                          |
|:---|:---|:---|:---|
| start_time       | 否    | String | 计划任务的生效开始时间。仅当recurrence_type不为空时生效，格式为yyyy-MM-dd'T'HH:mm'Z'，不填写时默认为任务创建成功的时间。                                              |
| end_time         | 否    | String | 计划任务的生效结束时间。仅当recurrence_type不为空时生效且必选，格式为yyyy-MM-dd'T'HH:mm'Z'。                                                            |
| launch_time      | 是    | String | 计划任务的执行时间。采用UTC时间，当recurrence_type不填写或为空时,格式为yyyy-MM-dd'T'HH:mm'Z'，当recurrence_type不为空时，格式为HH:mm。                           |
| recurrence_type  | 否    | String | 不填写或为空时计划任务为定时执行，填写时计划任务为周期执行，且只能填写DAILY、WEEKLY、MONTHLY 中的一种，分别为按天、按周、按月周期执行。                                               |
| recurrence_value | 否    | String | 仅当recurrence_type为WEEKLY、MONTHLY时必选，表示周期执行的具体日期，多个日期用,分隔，当recurrence_type为WEEKLY时，可填入1-7，当recurrence_type为MONTHLY时，可填入1-31。 |
   
 表4instance_number字段数据结构说明 
| 参数     | 是否必选 | 参数类型    | 描述       |
|:---|:---|:---|:---|
| max    | 否    | Integer | 伸缩组最大实例数 |
| min    | 否    | Integer | 伸缩组最小实例数 |
| desire | 否    | Integer | 伸缩组期望实例数 |
   
#### 请求示例
修改计划任务0h327883-324n-4dzd-9c61-68d03ee191dd，修改为每天17:00 将伸缩组的最大实例数设置为10，最小实例数设置为5。
```
PUT https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling-groups/{scaling_group_id}/scheduled-tasks/0h327883-324n-4dzd-9c61-68d03ee191dd
{
    "name": "task_01",
    "scheduled_policy": {
        "start_time": "2016-01-08T17:31Z",
        "end_time": "2016-02-08T17:31Z",
        "launch_time": "17:00",
        "recurrence_type": "DAILY"
    },
    "instance_number": {
        "max": 10,
        "min": 5
    }
}
```
#### 响应参数
无
#### 响应示例
无
#### 返回值
- 正常 204
  
- 异常
  
  | 返回值                               | 说明                           |
  |:---|:---|
  | 400 Bad Request                   | 服务器未能处理请求。                   |
  | 401 Unauthorized                  | 被请求的页面需要用户名和密码。              |
  | 403 Forbidden                     | 对被请求的页面访问禁止。                 |
  | 404 Not Found                     | 服务器无法找到被请求的页面。               |
  | 405 Method Not Allowed            | 请求中指定的方法不被允许。                |
  | 406 Not Acceptable                | 服务器生成的响应无法被客户端所接受。           |
  | 407 Proxy Authentication Required | 用户必须首先使用代理服务器进行验证，这样请求才会被处理。 |
  | 408 Request Timeout               | 请求超出了服务器的等待时间。               |
  | 409 Conflict                      | 由于冲突，请求无法被完成。                |
  | 500 Internal Server Error         | 请求未完成，服务异常。                  |
  | 501 Not Implemented               | 请求未完成，服务器不支持所请求的功能。          |
  | 502 Bad Gateway                   | 请求未完成，服务器从上游服务器收到一个无效的响应。    |
  | 503 Service Unavailable           | 请求未完成，系统暂时异常。                |
  | 504 Gateway Timeout               | 网关超时。                        |
     
  
 
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-as/as_07_0102.html)。