全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件
弹性伸缩

修改定时任务

更新时间:2017-06-07 13:26:11

描述

修改定时任务的属性。

请求参数

名称 类型 是否必须 描述
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

示例

请求示例
  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. "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
本文导读目录