阅读243 返回首页    go 微软 go windows

修改定时任务__定时任务相关功能_API参考_弹性伸缩-阿里云

描述

修改定时任务的属性。

请求参数

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

示例

请求示例

https://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"

最后更新：2016-11-23 16:03:52

  上一篇：go 删除伸缩规则__伸缩规则相关接口_API参考_弹性伸缩-阿里云
  下一篇：go 查询定时任务__定时任务相关功能_API参考_弹性伸缩-阿里云