ALIYUN::ESS::ScheduledTask类型用于根据指定参数创建定时任务。

语法

{
  "Type": "ALIYUN::ESS::ScheduledTask",
  "Properties": {
    "TaskEnabled": Boolean,
    "Description": String,
    "ScheduledTaskName": String,
    "LaunchExpirationTime": Integer,
    "LaunchTime": String,
    "RecurrenceEndTime": String,
    "RecurrenceType": String,
    "RecurrenceValue": String,
    "ScheduledAction": String
  }
}

属性

属性名称类型必须允许更新描述约束
TaskEnabledBoolean

是否启动定时任务

取值:
  • true(默认值):启动任务
  • false:停止任务
DescriptionString定时任务的描述信息长度为2~200个字符
ScheduledTaskNameString定时任务的显示名称

长度为2~40个字符,以数字、字母或中文字符开头,可包含数字、字母、中文字符、下划线(_)、短划线(-)或英文句点(.)。

同一用户账号同一地域内唯一。

如果没有指定该参数,默认为ScheduledScalingTaskId。

LaunchExpirationTimeInteger

定时任务触发操作失败后,在此时间内重试

取值范围:0~21600。

单位:秒。

默认值:600。

LaunchTimeString

定时任务触发的时间点

格式为:YYYY-MM-DDThh:mmZ
按照ISO8601标准表示,并需要使用UTC时间。
  • 如果指定了RecurrenceType,则此属性指定的时间点,默认为循环执行的时间点。
  • 如果未指定RecurrenceType,则按指定的日期和时间执行一次。
不能填写自创建或修改当天起90日后的时间。
RecurrenceEndTimeString

重复执行定时任务的结束时间

格式为:YYYY-MM-DDThh:mmZ

按照ISO8601标准表示,并需要使用UTC时间。

不能填写自创建或修改当天起90日后的时间。

RecurrenceType、RecurrenceValue和RecurrenceEndTime需要同时指定。

RecurrenceTypeString重复执行定时任务的类型取值:
  • Daily:每多少天重复执行一次定时任务。
  • Weekly:每周指定几天重复执行一次定时任务。
  • Monthly:每月内指定几天重复执行一次定时任务。
  • Cron:按照指定的Cron表达式执行定时任务。

RecurrenceType、RecurrenceValue和RecurrenceEndTime需要同时指定。

RecurrenceValueString重复执行定时任务的数值取值:
  • Daily:只能填一个值。取值范围:1~31。
  • Weekly:可以填入多个值。周日、周一……周六的值依次为:0, 1,2,…, 6,多天使用半角逗号(,)分隔。
  • Monthly:格式为A-B。A、B的取值范围为1~31,并且B必须大于等于A。
  • Cron:表示UTC时间,支持分、时、日、月、星期的5域表达式,支持半角逗号(,)、半角问号(?)、连字符(-)、星号(*)、井号(#)、正斜线(/)、L和W。

RecurrenceType、RecurrenceValue和RecurrenceEndTime需要同时指定。

ScheduledActionString

定时任务触发时需要执行的操作

最大支持200个字符。

此处填写伸缩规则的唯一标识符。

返回值

Fn::GetAtt

ScheduledTaskId: 定时任务的ID,由系统生成,全局唯一。

示例

  • YAML格式

    ROSTemplateFormatVersion: '2015-09-01'
    Resources:
      ScheduledTask:
        Type: ALIYUN::ESS::ScheduledTask
        Properties:
          TaskEnabled: 'true'
          Description: scheduledtask
          ScheduledTaskName: task1
          LaunchTime: 2014-08-17T16:52Z
          RecurrenceEndTime: 2014-08-17T16:55Z
          RecurrenceType: Daily
          RecurrenceValue: '1'
          ScheduledAction: ari:acs:ess:cn-qingdao:1344371:scalingRule/cCBpdYdQuBe2cUxOdu6piOk
    Outputs:
      ScheduledTaskId:
        Value:
          FN::GetAtt:
            - ScheduledTask
            - ScheduledTaskId
  • JSON格式

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Resources": {
        "ScheduledTask": {
          "Type": "ALIYUN::ESS::ScheduledTask",
          "Properties": {
            "TaskEnabled": "true",
            "Description": "scheduledtask",
            "ScheduledTaskName": "task1",
            "LaunchTime": "2014-08-17T16:52Z",
            "RecurrenceEndTime": "2014-08-17T16:55Z",
            "RecurrenceType": "Daily",
            "RecurrenceValue": "1",
            "ScheduledAction": "ari:acs:ess:cn-qingdao:1344371:scalingRule/cCBpdYdQuBe2cUxOdu6piOk"
          }
        }
      },
      "Outputs": {
        "ScheduledTaskId": {
          "Value": {
            "FN::GetAtt": [
              "ScheduledTask",
              "ScheduledTaskId"
            ]
          }
        }
      }
    }