全部产品
阿里云办公

修改定时任务

更新时间:2018-08-17 17:29:38

描述

修改定时任务的属性。

请求参数

名称 类型 是否必需 描述
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:每月内指定几天重复执行一次定时任务。
- Cron:按照指定的Cron表达式执行定时任务。
修改后,RecurrenceType、RecurrenceValue和RecurrenceEndTime需要同时有效。
RecurrenceValue String 重复执行定时任务的数值。
- Daily:只能填一个值,取值范围:[1,31]。
- Weekly:可以填入多值。周日、周一……周六的值依次为:0, 1,2,…, 6,多天使用英文字符“,”分隔。
- Monthly:格式为A-B。A、B的取值范围为[1,31] ,并且B必须大于等于A。
- Cron:支持分、时、日、月、星期的5域表达式,支持英文逗号(,)、连词符(-)、星号(*)、斜线(/)。
修改后,RecurrenceType、RecurrenceValue和RecurrenceEndTime需要同时有效。
RecurrenceEndTime String 重复执行定时任务的结束时间。按照ISO8601标准表示,并需要使用UTC时间。格式为:YYYY-MM-DDThh:mmZ
不能填写自创建或修改当天起90日后的时间。
修改后,RecurrenceType、RecurrenceValue和RecurrenceEndTime需要同时有效。
TaskEnabled Bool 是否启动定时任务。
- true为启动任务。
- false为停止任务。
默认为true。

返回参数

公共参数。

示例

请求示例

  1. http://ess.aliyuncs.com/?Action=ModifyScheduledTask
  2. &ScheduledTaskId=edRtShc57WGXdt8TlPbrjsnV
  3. &LaunchTime=2014-08-18T10:52Z
  4. &RecurrenceEndTime=2014-08-20T16:55Z
  5. &<公共请求参数>

返回示例

XML 格式

  1. <ModifyScheduledTaskResponse>
  2. <RequestId>F9372E8D-C163-471F-BEB4-3A02B3CE176E</RequestId>
  3. </ModifyScheduledTaskResponse>

JSON 格式

  1. {
  2. "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
  3. }

错误码

对于所有接口的通用性错误,请参考客户端错误表服务器端错误表

错误代码 错误信息 HTTP 状态码 描述
InvalidScheduledTaskId.NotFound The specified scheduled task does not exist. 404 指定的定时任务在该用户账号下不存在。
InvalidScheduledTaskName.Duplicate The specified value of parameter ScheduledTaskName is duplicated. 400 定时任务名已存在。
ScheduledAction.RegionMismatch The specified scheduled task and the specified scheduled action are not in the same Region. 400 指定的ScheduledAction与定时任务所在的地域不匹配。