ModifyScheduledTask

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

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

阿里云

冷却时间

本文主要介绍弹性伸缩的冷却时间。冷却时间指成功执行伸缩活动后的一段锁定时间。您可以通过以下两种方式配置冷却时间：在伸缩组中配置默认冷却时间，默认冷却时间不能为空，请参照。在伸缩规则中配置冷却时间，如果不配置，将使用默认冷却时间，请参照。说明如果同时在伸缩组和伸缩规则…

2019年9月3日
阿里云

AttachLoadBalancers

添加一个或多个负载均衡实例。描述由于存在，向伸缩组添加负载均衡实例时需要满足以下条件：负载均衡实例与伸缩组必须属于同一账号。负载均衡实例与伸缩组必须处于同一地域。负载均衡实例必须处于运行中状态。负载均衡实例至少配置有一个监听且必须开启健康检查。如果负载均衡实例与伸…

2019年9月3日
阿里云

DescribeNotificationTypes

查询弹性伸缩事件及资源变化通知类型（DescribeNotificationTypes）。请求参数名称类型是否必选描述 Action String 是系统规定参数。取值：DescribeNotificationTypes。返回参数名称类型描述 RequestI…

2019年3月21日
阿里云

DeleteScalingGroup

本文介绍删除伸缩组 API 操作。描述删除一个指定的伸缩组。 ForceDelete属性表示如果伸缩组存在ECS实例或正在进行伸缩活动，是否强制删除伸缩组并移出和释放ECS实例。如果ForceDelete属性为false，必须满足以下两个条件，才能删除伸缩组：条件一：伸缩…

2019年9月3日
阿里云

AttachInstances

往指定的伸缩组添加ECS实例。描述加入的ECS实例的限定条件包括：加入的ECS实例必须与伸缩组在同一个地域。加入的ECS实例必须是running状态。加入的ECS实例不能已加入到其它伸缩组中。加入的ECS实例支持包年包月和按量付费两种类型。如果伸缩组指定Vswitc…

2019年3月21日
阿里云

系统监控报警任务

本文主要介绍系统监控报警任务。系统监控报警任务的监控指标是云监控为用户采集的 ECS 实例的相关数据指标，以伸缩组作为监控粒度，即以伸缩组内所有实例的监控指标的统计平均值作为伸缩组的指标值。当伸缩组内实例数量发生变化时，监控指标也会同时进行更新。支持的监控指标目前，系统监控…

2019年9月3日

发表评论