ModifyScheduledTask

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

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

阿里云

系统监控报警任务

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

2019年3月21日
阿里云

阿里云弹性伸缩都有哪些常见的调用方式？

本文介绍调用方式。对弹性伸缩 API 接口调用是通过向弹性伸缩 API 的服务端地址发送 HTTP GET 请求，并按照接口说明在请求中加入相应请求参数来完成的。根据请求的处理情况，系统会返回处理结果。赞微海报分享

2019年9月3日
阿里云

阿里云弹性伸缩API使用须知

在调用弹性伸缩 OpenAPI 之前，需要在阿里云官网先开通弹性伸缩服务，并在弹性伸缩控制台将用户的 OpenAPI 权限授权予弹性伸缩。具体操作请参见。前提条件在调用弹性伸缩 OpenAPI 之前，需要在阿里云官网先开通弹性伸缩服务，并在弹性伸缩控制台将用户的 Open…

2019年9月3日
阿里云

AttachDBInstances

添加一个或多个 RDS 实例。描述由于存在使用限制，向伸缩组添加 RDS 实例时需要满足以下条件： RDS 实例与伸缩组必须属于同一账号。 RDS 实例必须处于未锁定状态，关于锁定策略，请参考。 RDS 实例必须处于运行中状态。添加 RDS 实例后，RDS IP …

2019年9月3日
阿里云

强制干预

本文主要介绍强制干预相关内容。弹性伸缩服务不会阻止用户从 ECS 控制台删除自动创建的 ECS 实例等强制干预行为。对于用户的强制干预，弹性伸缩服务的处理方法如下。资源强制干预类型弹性伸缩服务的处理方法 ECS 通过 ECS 控制台或 OpenAPI 强制删除伸缩组里的…

2019年3月21日
阿里云

CreateScheduledTask

调用CreateScheduledTask接口创建一个定时任务。接口说明一个账号下最多创建20个定时任务。由于伸缩组正在发生伸缩活动或者伸缩组停用等原因，导致定时任务触发执行伸缩规则失败后，在LaunchExpirationTime内，定时任务会自动重试触发，否则放弃本次定…

2019年9月3日

发表评论