修改定时任务的属性。
请求参数
名称 | 类型 | 是否必选 | 描述 |
---|---|---|---|
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 | 否 | 重复执行定时任务的类型。可选值:
修改后,RecurrenceType、RecurrenceValue和RecurrenceEndTime需要同时有效。 |
RecurrenceValue | String | 否 | 重复执行定时任务的数值。
修改后,RecurrenceType、RecurrenceValue和RecurrenceEndTime需要同时有效。 |
RecurrenceEndTime | String | 否 | 重复执行定时任务的结束时间。按照ISO8601标准表示,并需要使用UTC时间。格式为:YYYY-MM-DDThh:mmZ
不能填写自创建或修改当天起90日后的时间。 修改后,RecurrenceType、RecurrenceValue和RecurrenceEndTime需要同时有效。 |
TaskEnabled | Bool | 否 | 是否启动定时任务。
默认为true。 |
返回参数
公共参数。
示例
请求示例
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"
}
错误码
对于所有接口的通用性错误,请参考 客户端错误 或 服务器端错误。
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
404 | InvalidScheduledTaskId.NotFound | The specified scheduled task does not exist. | 指定的定时任务在该用户账号下不存在。 |
400 | 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. | 指定的ScheduledAction与定时任务所在的地域不匹配。 |
发布者:佚, 佚名,转转请注明出处:https://www.cms2.cn/aliyun/1590.html