定时任务：修改定时任务
描述
修改定时任务的属性。
请求参数
| 名称 | 类型 | 是否必须 | 描述 |
| Action | String | 是 | 操作接口名，系统规定参数，取值：ModifyScheduledTask。 |
| ScheduledTaskId | String | 是 | 定时任务的ID。 |
| ScheduledTaskName | String | 否 | 定时任务的显示名称，2-40 个英文或中文字符，以数字、大小字母或中文开头，可包含数字，“_”、“-”或“.”。同一用户账号同一地域内唯一。如果没有指定该参数，默认值为ScheduledScalingTaskId。 |
| Description | String | 否 | 定时任务的描述信息。2-200 个英文或中文字符。 |
| ScheduledAction | String | 否 | 定时任务触发时需要执行的操作。此处填写伸缩规则的唯一标识符。 |
| LaunchTime | String | 否 | 定时任务触发的时间点。按照ISO8601标准表示，并需要使用UTC时间。格式为：YYYY-MM-DDThh:mmZ。如果指定了RecurrenceType，则此属性指定的时间点，默认为循环执行的时间点。如果未指定RecurrenceType，则按指定的日期和时间执行一次。不能填写自创建或修改当天起90日后的时间。 |
| LaunchExpirationTime | Integer | 否 | 定时任务触发操作失败后，在此时间内重试。默认600秒。取值范围：[0, 21600] |
| RecurrenceType | String | 否 | 重复执行定时任务的类型。可选值：- Daily：每多少天重复执行一次定时任务。- Weekly：每周指定几天重复执行一次定时任务。- Monthly：每月内指定几天重复执行一次定时任务。修改后，RecurrenceType、RecurrenceValue和RecurrenceEndTime需要同时有效。 |
| RecurrenceValue | String | 否 | 重复执行定时任务的数值。- Daily：只能填一个值，取值范围：[1,31]。- Weekly：可以填入多值。周日、周一……周六的值依次为：0, 1,2,…, 6，多天使用英文字符“,”分隔。- Monthly：格式为A-B。A、B的取值范围为[1,31] ，并且B必须大于等于A。修改后，RecurrenceType、RecurrenceValue和RecurrenceEndTime需要同时有效。 |
| RecurrenceEndTime | String | 否 | 重复执行定时任务的结束时间。按照ISO8601标准表示，并需要使用UTC时间。格式为：YYYY-MM-DDThh:mmZ不能填写自创建或修改当天起90日后的时间。修改后，RecurrenceType、RecurrenceValue和RecurrenceEndTime需要同时有效。 |
| TaskEnabled | Bool | 否 | 是否启动定时任务。- true为启动任务。- false为停止任务。默认为true。 |
返回参数
公共参数。
错误码
对于所有接口的通用性错误，请参考 客户端错误表或 服务器端错误表。
| 错误 | 错误代码 | 描述 | HTTP状态码 |
| 指定的定时任务在该用户账号下不存在 | InvalidScheduledTaskId.NotFound | The specified scheduled task does not exist. | 404 |
| 定时任务名已存在 | InvalidScheduledTaskName.Duplicate | The specified value of parameter <parameter name> is duplicated. | 400 |
| 指定的ScheduledAction与定时任务所在的地域不匹配 | ScheduledAction.RegionMismatch | The specified scheduled task and the specified scheduled action are not in the same Region. | 400 |
示例
请求示例
- http://ess.aliyuncs.com/?Action=ModifyScheduledTask
- &ScheduledTaskId=edRtShc57WGXdt8TlPbrjsnV
- &LaunchTime=2014-08-18T10:52Z
- &RecurrenceEndTime=2014-08-20T16:55Z
- &<公共请求参数>
返回示例
XML格式：
- <ModifyScheduledTaskResponse>
- <RequestId>F9372E8D-C163-471F-BEB4-3A02B3CE176E</RequestId>
- </ModifyScheduledTaskResponse>
JSON格式：
- "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
展开
收起
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
相关问答
问答排行榜
最热
最新
推荐问答
