调用CreateScheduledTask创建一个定时任务_弹性伸缩-阿里云帮助中心

创建一个定时任务。

接口说明

由于伸缩组正在发生伸缩活动或者伸缩组停用等原因，导致定时任务触发执行伸缩规则失败后，在LaunchExpirationTime内，定时任务会自动重试触发，否则放弃本次定时触发。
如果多个定时任务在相近的时间内触发执行同一个伸缩组的伸缩规则，则最早触发的定时任务会先执行伸缩活动。由于同一个伸缩组同一时刻内只能有一个伸缩活动，排在后面的定时任务会在LaunchExpirationTime内自动重试定时触发。如上一个伸缩活动完成之后，排在后面的定时任务还在LaunchExpirationTime内重试，则执行该定时任务的伸缩规则并触发相应的伸缩活动。
定时任务支持以下两种伸缩方式：
- 通过ScheduledAction参数设置需要执行的伸缩规则。
- 通过ScalingGroupId参数设置伸缩组内实例数量。

说明不支持同时设置ScheduledAction和ScalingGroupId。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	定时任务所属地域的ID。	cn-qingdao
ScheduledTaskName	string	否	定时任务的名称。2~64个英文或中文字符，以数字、大小字母或中文开头，可包含数字、下划线（_）、短划线（-）或半角句号（.）。同一账号同一地域内唯一。默认值为`ScheduledTaskId`的值。	scheduled****
Description	string	否	定时任务的描述信息，长度为2~200个英文或中文字符。	Test scheduled task.
ScheduledAction	string	否	定时任务触发时需要执行的伸缩规则，填写伸缩规则的唯一标识符。指定`ScheduledAction`后，定时任务的伸缩方式为选择已有伸缩规则。说明不支持同时设置`ScheduledAction`和`ScalingGroupId`。	ari:acs:ess:cn-hangzhou:140692647**:scalingrule/asr-bp12tcnol686y1ik**
RecurrenceEndTime	string	否	重复执行定时任务的结束时间。按照ISO8601标准表示，并需要使用UTC时间。格式为：YYYY-MM-DDThh:mmZ。不能填写自创建当天起365日后的时间。	2014-08-17T16:55Z
LaunchTime	string	否	定时任务触发的时间点。按照ISO8601标准表示，并需要使用UTC时间。格式为：YYYY-MM-DDThh:mmZ。不能填写自创建当天起90日后的时间。如果指定了`RecurrenceType`，则此属性指定的时间点，默认为循环执行的时间点。如果未指定`RecurrenceType`，则按指定的日期和时间执行一次。	2014-08-17T16:52Z
RecurrenceType	string	否	重复执行定时任务的类型，取值范围： Daily：每多少天重复执行一次定时任务。 Weekly：每周指定几天重复执行一次定时任务。 Monthly：每月内指定几天重复执行一次定时任务。 Cron：按照指定的Cron表达式执行定时任务。您需要同时指定`RecurrenceType`和`RecurrenceValue`。	Daily
RecurrenceValue	string	否	重复执行定时任务的数值。 `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时间，支持分、时、日、月、星期的五个域表达式，支持通配符半角逗号（,）、半角问号（?）、短划线（-）、星号（*）、井号（#）、正斜线（/）、L和W。您需要同时指定`RecurrenceType`和`RecurrenceValue`。	1
TaskEnabled	boolean	否	是否启动定时任务。 true：启动任务。 false：停止任务。默认值：true	true
LaunchExpirationTime	integer	否	定时任务触发操作失败后，在此时间内重试。单位为秒，取值范围：0~1800。默认值：600。	600
MinValue	integer	否	定时任务的伸缩方式为设置伸缩组内实例数量时，指定伸缩组内实例的最小数量。	0
MaxValue	integer	否	定时任务的伸缩方式为设置伸缩组内实例数量时，指定伸缩组内实例的最大数量。	10
DesiredCapacity	integer	否	定时任务的伸缩方式为设置伸缩组内实例数量时，指定伸缩组内实例的期望实例数。说明伸缩组必须支持设置期望实例数，即在创建该伸缩组时指定了`DesiredCapacity`。	10
ScalingGroupId	string	否	定时任务触发时需要修改实例数量的伸缩组，填写伸缩组ID。指定`ScalingGroupId`后，定时任务的伸缩方式为设置伸缩组内实例数量，您需要为`MinValue`、`MaxValue`和`DesiredCapacity`中至少一个参数指定数量。说明不支持同时设置`ScheduledAction`和`ScalingGroupId`。	asg-bp18p2yfxow2dloq****

返回参数

名称	类型	描述	示例值
	object
ScheduledTaskId	string	定时任务的ID，由系统生成，全局唯一。	edRtShc57WGXdt8TlPbr****
RequestId	string	请求ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

示例

正常返回示例

JSON格式

{
  "ScheduledTaskId": "edRtShc57WGXdt8TlPbr****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

错误码

访问错误中心查看更多错误码。