ModifyScheduledTask

lidazhuang • 2019年9月3日 am9:26 • 阿里云 • 阅读 358

调用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	重复执行定时任务的类型。可选值： Daily：每多少天重复执行一次定时任务。 Weekly：每周指定几天重复执行一次定时任务。 Monthly：每月内指定几天重复执行一次定时任务。 Cron：按照指定的Cron表达式执行定时任务。修改后，RecurrenceType、RecurrenceValue和RecurrenceEndTime需要同时有效。
RecurrenceValue	String	否	2	重复执行定时任务的数值。 RecurrenceType取Daily时，只能填一个值，取值范围：1~31。 RecurrenceType取Weekly时，可以填入多个值，填多个值时使用英文逗号（,）分隔。比如，周日、周一、周二、周三、周四、周五、周六的值依次为：0,1,2,3,4,5,6。 RecurrenceType取Monthly时，格式为A-B。A、B的取值范围为1~31，并且B必须大于等于A。 RecurrenceType取Cron时，表示UTC时间，支持分、时、日、月、星期的5域表达式，支持通配符英文逗号（,）、英文问号（?）、连词符（-）、星号（）、井号（#）、斜线（/）、L和W。修改后，RecurrenceType、RecurrenceValue和RecurrenceEndTime*需要同时有效。
RecurrenceEndTime	String	否	2014-08-20T16:55Z	重复执行定时任务的结束时间。按照ISO8601标准表示，并需要使用UTC时间。格式为：YYYY-MM-DDThh:mmZ。不能填写自修改当天起365日后的时间。修改后，RecurrenceType、RecurrenceValue和RecurrenceEndTime需要同时有效。
TaskEnabled	Boolean	否	true	是否启动定时任务。 true：启动任务。 false：停止任务。
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 `ScheduledTaskName` is duplicated.	定时任务名已存在。
400	ScheduledAction.RegionMismatch	The specified scheduled task and the specified scheduled action are not in the same Region.	指定的ScheduledAction与定时任务所在的地域不匹配。

发布者：lidazhuang，转转请注明出处：https://www.cms2.cn/aliyun/4554.html

赞 (0)

打赏

微信扫一扫

0

DetachInstances

上一篇 2019年9月3日 am9:25

ModifyLifecycleHook

下一篇 2019年9月3日 am9:26

阿里云

弹性伸缩FAQ

如何避免因某个实例规格库存不足导致扩容失败？建议在创建伸缩组的时候设置多可用区（可用区下选择不同的Vswitch），创建伸缩配置的时候选择多实例规格，当某个ECS实例规格在某个可用区没有库存时，弹性伸缩服务会自动切换到有库存的实例规格及可用区进行扩容。更多说明请参考或。报警任…

2019年9月3日
阿里云

ModifyNotificationConfiguration

修改您创建的弹性伸缩事件及资源变化通知（ModifyNotificationConfiguration）。调试前往【】在线调试，API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力，能显著降低使用云 API 的难度，强烈推…

2019年9月3日
阿里云

伸缩活动中失败实例的回滚

本文主要介绍伸缩活动中失败实例的回滚。伸缩活动有 ECS 实例加入伸缩组失败时，需要保持 ECS 实例级事务的完整性，而非伸缩活动级事务的完整性，即只进行 ECS 实例级回滚，而不是伸缩活动级回滚。例如，当伸缩组创建了 20 台 ECS 实例，但只有 19 台 ECS 实例成…

2019年3月21日
阿里云

DeleteScalingRule

本文介绍删除伸缩规则 API 操作。描述删除一个指定的伸缩规则。调试前往【】在线调试，API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力，能显著降低使用云 API 的难度，强烈推荐使用。请求参数名称类型是否必…

2019年9月3日
阿里云

EnableScalingGroup

本文介绍启用伸缩组API操作。描述启用一个指定的伸缩组。启用伸缩组成功以后（active 状态），会先把接口中指定的 ECS 实例加入伸缩组。接口中指定的 ECS 实例成功加入伸缩组后，如果当前 ECS 实例数量仍小于 MinSize，则弹性伸缩服务会自动创建差额的按量付…

2019年9月3日
阿里云

管理定时任务

定时任务创建完成后，您可以根据需要随时停用、启用、修改和删除定时任务，灵活应对业务变化。停用或启用定时任务定时任务创建完成后自动启用，您可以手动停用暂时不需要执行的定时任务。登录。依次单击自动触发任务管理 > 定时任务。在定时任务页面中，单击定时任务操作列下的停用…

2019年9月3日

发表评论