ModifyScheduledTask

修改定时任务的属性。

请求参数

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

返回参数

公共参数。

示例

请求示例

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

发表评论

邮箱地址不会被公开。 必填项已用*标注