模板名称
ACS-ECS-ScheduleToStartInstances 定时启动ECS实例
模板描述
定时启动ECS实例,适用于需要定时启动ECS实例的场景,例如按时间段自动开启开发环境或测试环境。在配置过程中,用户需要提供下列必填参数信息:地域ID(regionId):用于指定操作实例的地域,cron表达式(cron):用于定义任务的定时触发规则,目标实例(targets):用于定义具体需要操作的ECS实例。模板在执行后会根据设置的时间表定时启动ECS实例。
模板类型
自动化
所有者
Alibaba Cloud
输入参数
参数名称 | 描述 | 类型 | 是否必填 | 默认值 | 约束 |
endDate | 时间触发器结束时间 | String | 是 | ||
targets | 目标实例 | Json | 是 | ||
regionId | 地域ID | String | 否 | {{ ACS::RegionId }} | |
cron | cron表达式 | String | 否 | 0 0 12 ? * * | |
timeZone | 时区 | String | 否 | UTC | |
rateControl | 任务执行的并发比率 | Json | 否 | {‘Mode’: ‘Concurrency’, ‘MaxErrors’: 0, ‘Concurrency’: 10} | |
OOSAssumeRole | OOS扮演的RAM角色 | String | 否 | OOSServiceRole |
输出参数
参数名称 | 描述 | 类型 |
instanceIds | List |
执行此模板需要的权限策略
{
"Version": "1",
"Statement": [
{
"Action": [
"ecs:DescribeInstances",
"ecs:StartInstance"
],
"Resource": "*",
"Effect": "Allow"
}
]
}
详情
ACS-ECS-ScheduleToStartInstances详情
模板内容
FormatVersion: OOS-2019-06-01
Description:
en: 'Schedule to start the ECS instances, applicable to scenarios where ECS instances need to be started at scheduled times, such as automatically starting development or test environments within specific periods. During configuration, users need to provide the following required parameter information: Region ID (regionId), which specifies the region of the ECS instances to be operated on, Cron Expression (cron), which defines the schedule for the task, and Target Instances (targets), which defines the specific ECS instances to be operated on. Upon execution, the template will start the ECS instances according to the configured schedule.'
zh-cn: 定时启动ECS实例,适用于需要定时启动ECS实例的场景,例如按时间段自动开启开发环境或测试环境。在配置过程中,用户需要提供下列必填参数信息:地域ID(regionId):用于指定操作实例的地域,cron表达式(cron):用于定义任务的定时触发规则,目标实例(targets):用于定义具体需要操作的ECS实例。模板在执行后会根据设置的时间表定时启动ECS实例。
name-en: ACS-ECS-ScheduleToStartInstances
name-zh-cn: 定时启动ECS实例
categories:
- time_trigger
Parameters:
regionId:
Type: String
Label:
en: RegionId
zh-cn: 地域ID
AssociationProperty: RegionId
Default: '{{ ACS::RegionId }}'
cron:
Description:
en: 'refer them here: https://help.aliyun.com/document_detail/169784.html'
zh-cn: '详情参考:https://help.aliyun.com/document_detail/169784.html'
Label:
en: CronExpression
zh-cn: cron表达式
Type: String
AssociationProperty: Cron
Default: 0 0 12 ? * *
endDate:
Description:
en: 'Format: yyyy-MM-ddTHH:mm:ssZ.'
zh-cn: '格式:yyyy-MM-ddTHH:mm:ssZ'
Label:
en: EndDate
zh-cn: 时间触发器结束时间
Type: String
AssociationProperty: DateTime
AssociationPropertyMetadata:
Format: 'YYYY-MM-DDTHH:mm:ssZ'
timeZone:
Label:
en: TimeZone
zh-cn: 时区
Type: String
AssociationProperty: TimeZone
Default: UTC
targets:
Type: Json
Label:
en: TargetInstance
zh-cn: 目标实例
AssociationProperty: Targets
AssociationPropertyMetadata:
ResourceType: 'ALIYUN::ECS::Instance'
RegionId: regionId
rateControl:
Label:
en: RateControl
zh-cn: 任务执行的并发比率
Type: Json
AssociationProperty: RateControl
Default:
Mode: Concurrency
MaxErrors: 0
Concurrency: 10
OOSAssumeRole:
Label:
en: OOSAssumeRole
zh-cn: OOS扮演的RAM角色
Type: String
Default: OOSServiceRole
RamRole: '{{ OOSAssumeRole }}'
Tasks:
- Name: timerTrigger
Action: ACS::TimerTrigger
Description:
en: Triggers a task as scheduled by specifying type and expression
zh-cn: 通过指定触发类型和表达式按计划触发任务
Properties:
Type: cron
Expression: '{{ cron }}'
EndDate: '{{ endDate }}'
TimeZone: '{{ timeZone }}'
- Name: getInstance
Description:
en: Views the ECS instances.
zh-cn: 获取ECS实例。
Action: ACS::SelectTargets
Properties:
ResourceType: ALIYUN::ECS::Instance
RegionId: '{{ regionId }}'
Filters:
- '{{ targets }}'
Outputs:
instanceIds:
Type: List
ValueSelector: Instances.Instance[].InstanceId
- Name: startInstance
Action: ACS::ECS::StartInstance
Description:
en: Starts the ECS instances.
zh-cn: 启动实例。
Properties:
regionId: '{{ regionId }}'
instanceId: '{{ ACS::TaskLoopItem }}'
Loop:
RateControl: '{{ rateControl }}'
Items: '{{ getInstance.instanceIds }}'
Outputs:
instanceIds:
Type: List
Value: '{{ getInstance.instanceIds }}'
Metadata:
ALIYUN::OOS::Interface:
ParameterGroups:
- Parameters:
- timeZone
- cron
- endDate
Label:
default:
zh-cn: 定时设置
en: Timer Trigger Configure
- Parameters:
- regionId
- targets
Label:
default:
zh-cn: 选择实例
en: Select ECS Instances
- Parameters:
- rateControl
- OOSAssumeRole
Label:
default:
zh-cn: 高级选项
en: Control Options