更新计划任务
功能介绍
更新弹性伸缩计划任务。
调试
您可以在API Explorer中调试该接口。
URI
PUT /autoscaling-api/v1/{project_id}/scaling-groups/{scaling_group_id}/scheduled-tasks/{scheduled_task_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID |
scaling_group_id |
是 |
String |
伸缩组ID |
scheduled_task_id |
是 |
String |
计划任务ID |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
否 |
String |
计划任务名称 |
scheduled_policy |
否 |
Object |
计划任务策略,请参考表3 |
instance_number |
否 |
Object |
伸缩组实例数,请参考表4 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
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。 |
请求示例
修改计划任务0h327883-324n-4dzd-9c61-68d03ee191dd,修改为每天17:00 将伸缩组的最大实例数设置为10,最小实例数设置为5。
PUT https://{Endpoint}/v1/{project_id}/scaling-groups/xxxxxx/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 } }
响应参数
无
响应示例
无
返回值
- 正常
- 异常
返回值
说明
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
网关超时。
错误码
请参考错误码。