ModifyScheduledTask

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

调用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

阿里云

DeleteScalingConfiguration

删除一个指定的伸缩配置。描述伸缩配置在伸缩组中属于生效状态，则该伸缩配置不允许删除。某个伸缩配置创建的任意一个ECS实例仍存在于伸缩组中，则该伸缩配置不允许删除。调试前往【】在线调试，API Explorer 提供在线调用 API、动态生成 SDK Example 代码…

2019年9月3日
阿里云

伸缩活动的流程

本文主要介绍弹性伸缩的伸缩活动流程。伸缩活动的生命周期为判断伸缩组的健康状态和边界条件步骤与启动 cooldown 步骤之间的所有活动。伸缩组自动伸缩自动扩展判断伸缩组的健康状态和边界条件。分配 ActivityId 和执行伸缩活动。创建 ECS 实例。修改 Tot…

2019年9月3日
添加ECS实例

本文介绍如何手动向伸缩组添加一个ECS实例。前提条件手动添加ECS实例前，请确保待添加的ECS实例满足以下条件：实例必须与伸缩组处于同一个地域。实例不能已加入到其它伸缩组中。实例的状态必须是运行中。实例的网络类型可以为经典网络或专有网络，但有以下限制：当伸缩组的网络…

2019年3月21日 • 阿里云
阿里云

阿里云弹性伸缩怎么通过通过扩缩容策略降低成本

本文介绍如何基于多实例规格和多可用区应用成本优化策略，提高弹性伸缩的成功率，同时降低成本。背景信息弹性伸缩支持多实例规格，您可以在伸缩配置中指定备选的实例规格。在无法弹出高优先级规格的实例时，弹性伸缩会自动尝试下一优先级规格的实例，直至成功创建实例。多实例规格可以有效应对单个…

2019年9月3日
阿里云

自定义监控项报警任务

本文主要介绍弹性伸缩自定义监控项报警任务。弹性伸缩自定义监控项报警任务的监控对象为用户自主上报到云监控中的监控指标。在一些场景下，系统监控项可能不包含您所需要的监控指标，您可能拥有自己的一套监控系统，并且关心的是与您特定业务相关的某些指标,自定义监控报警任务，为您自有的监控系统…

2019年3月21日
阿里云

伸缩活动的状态

本文主要介绍弹性伸缩的伸缩活动状态。伸缩活动在请求阶段被拒绝，为 Rejected 状态。伸缩活动执行过程中，为 InProgress 状态。伸缩活动执行完成后，有 3 种状态：成功（Successful）：根据 Minsize、MaxSize 调整后的伸缩规则，伸缩活动…

2019年3月21日

发表评论