ModifyScheduledTask
调用ModifyScheduledTask接口修改一个定时任务的属性。
调试
前往【】在线调试,API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力,能显著降低使用云 API 的难度,强烈推荐使用。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
ScheduledTaskId | String | 是 | edRtShc57WGXdt8TlPbr**** |
定时任务的ID。 |
Action | String | 否 | ModifyScheduledTask |
操作接口名,系统规定参数,取值:ModifyScheduledTask。 |
ScheduledTaskName | String | 否 | scheduled**** |
定时任务的显示名称。2~64个英文或中文字符,以数字、大小字母或中文开头,可包含数字、下划线(_)、连词符(-)或英文句号(.)。 同一账号同一地域内唯一。 |
Description | String | 否 | fortest |
定时任务的描述信息。2~200个英文或中文字符。 |
ScheduledAction | String | 否 | ari:acs:ess:cn-qingdao:1344371:scalingRule/cCBpdYdQuBe2cUxOdu6**** |
定时任务触发时需要执行的操作,填写伸缩规则的唯一标识符。 |
LaunchTime | String | 否 | 2014-08-18T10:52Z |
定时任务触发的时间点。 按照ISO8601标准表示,并需要使用UTC时间。格式为:YYYY-MM-DDThh:mmZ。不能填写自修改当天起90日后的时间。 如果指定了RecurrenceType,则此属性指定的时间点,默认为循环执行的时间点。 如果未指定RecurrenceType,则按指定的日期和时间执行一次。 |
RecurrenceType | String | 否 | Daily |
重复执行定时任务的类型。可选值:
修改后,RecurrenceType、RecurrenceValue和RecurrenceEndTime需要同时有效。 |
RecurrenceValue | String | 否 | 2 |
重复执行定时任务的数值。
修改后,RecurrenceType、RecurrenceValue和RecurrenceEndTime需要同时有效。 |
RecurrenceEndTime | String | 否 | 2014-08-20T16:55Z |
重复执行定时任务的结束时间。按照ISO8601标准表示,并需要使用UTC时间。格式为:YYYY-MM-DDThh:mmZ。不能填写自修改当天起365日后的时间。 修改后,RecurrenceType、RecurrenceValue和RecurrenceEndTime需要同时有效。 |
TaskEnabled | Boolean | 否 | true |
是否启动定时任务。
|
LaunchExpirationTime | Integer | 否 | 600 |
定时任务触发操作失败后,在此时间内重试。单位为秒,取值范围:0~21600。 |
返回参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
请求ID。 |
示例
请求示例
http://ess.aliyuncs.com/?Action=ModifyScheduledTask
&ScheduledTaskId=edRtShc57WGXdt8TlPbr****
&LaunchTime=2014-08-18T10:52Z
&RecurrenceEndTime=2014-08-20T16:55Z
&<公共请求参数>
正常返回示例
XML
格式
<ModifyScheduledTaskResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyScheduledTaskResponse>
JSON
格式
{
"RequestId":"473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
错误码
HttpCode |
错误码 |
错误信息 |
描述 |
---|---|---|---|
404 |
InvalidScheduledTaskId.NotFound |
The specified scheduled task does not exist. |
指定的定时任务在该用户账号下不存在。 |
400 |
InvalidScheduledTaskName.Duplicate |
The specified value of parameter
is duplicated. |
定时任务名已存在。 |
400 |
ScheduledAction.RegionMismatch |
The specified scheduled task and the specified scheduled action are not in the same |
指定的ScheduledAction与定时任务所在的地域不匹配。 |
发布者:lidazhuang,转转请注明出处:https://www.cms2.cn/aliyun/4554.html