创建弹性伸缩策略 - CreateScalingPolicy

project_id

是

String

参数解释：

项目ID。获取方式请参见获取项目ID。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

scaling_policy_name

是

String

参数解释：

伸缩策略名称。

约束限制：

不涉及

取值范围：

1-64个字符，只能包含中文、字母、数字、下划线或中划线。

默认取值：

不涉及

scaling_group_id

是

String

参数解释：

伸缩组ID，通过查询弹性伸缩组列表获取，请参考查询弹性伸缩组列表 - ListScalingGroups。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

scaling_policy_type

是

String

参数解释：

策略类型

约束限制：

不涉及

取值范围：

• 告警策略：ALARM(与alarm_id对应)
• 定时策略：SCHEDULED(与scheduled_policy对应)
• 周期策略：RECURRENCE(与scheduled_policy对应)

默认取值：

不涉及

alarm_id

否

String

参数解释：

告警ID，即告警规则的ID。创建告警策略成功后，会自动为该告警ID对应的告警规则的alarm_actions字段增加类型为autoscaling的告警触发动作。

告警ID通过查询云监控告警规则列表获取，请参考《云监控API参考》的“查询告警规则列表”。

约束限制：

当scaling_policy_type为ALARM时该项必选，此时scheduled_policy不生效。

取值范围：

不涉及

默认取值：

不涉及

scheduled_policy

否

scheduled_policy object

参数解释：

定时、周期任务策略。详情请见表 scheduled_policy字段数据结构说明。

约束限制：

当scaling_policy_type为SCHEDULED或RECURRENCE时该项必选，此时alarm_id不生效。

scaling_policy_action

否

scaling_policy_action object

参数解释：

策略执行具体动作。详情请见表 scaling_policy_action字段数据结构说明。

约束限制：

不涉及

cool_down_time

否

Integer

参数解释：

冷却时间，单位是秒。

约束限制：

伸缩组在冷却时间内，会拒绝告警策略的触发，其他类型的伸缩策略（如定时策略和周期策略）及手动触发不受限制。

取值范围：

0-86400秒

默认取值：

300

launch_time

是

String

参数解释：

触发时间，遵循UTC时间。

约束限制：

• 如果scaling_policy_type为SCHEDULED，则格式为：YYYY-MM-DDThh:mmZ。
• 如果scaling_policy_type为RECURRENCE，则格式为：hh:mm。

取值范围：

不涉及

默认取值：

不涉及

recurrence_type

否

String

参数解释：

周期触发类型。

约束限制：

scaling_policy_type为RECURRENCE时该项必选。

取值范围：

• Daily：每天执行一次
• Weekly：每周指定天执行一次。
• Monthly：每月指定天执行一次。

默认取值：

不涉及

recurrence_value

否

String

参数解释：

周期触发任务数值。

约束限制：

scaling_policy_type为RECURRENCE时该项必选。

取值范围：

• 类型为Daily时，该字段为null，表示每天执行
• 类型为Weekly时，该字段取值范围为1-7，1表示星期日，以此类推，以“,”分隔，例如：1,3,5。
• 类型为Monthly时，该字段取值范围为1-31，分别表示每月的日期，以“,”分隔，例如：1,10,13,28。

默认取值：

不涉及

start_time

否

String

参数解释：

周期策略重复执行开始时间，遵循UTC时间。

格式为：YYYY-MM-DDThh:mmZ。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

默认为当前时间。

end_time

否

String

参数解释：

周期策略重复执行结束时间，遵循UTC时间。

格式为：YYYY-MM-DDThh:mmZ。

约束限制：

• scaling_policy_type为RECURRENCE时该项必选。
• 当为周期类型策略时，不得早于当前时间和开始时间。

取值范围：

不涉及

默认取值：

不涉及

operation

否

String

参数解释：

操作选项。

约束限制：

不涉及

取值范围：

• 当scaling_resource_type为SCALING_GROUP，支持如下操作：
  • ADD：增加
  • REMOVE/REDUCE：减少
  • SET：设置为
• 当scaling_resource_type为BANDWIDTH，支持如下操作：
  • ADD：增加
  • REDUCE：减少
  • SET：设置为

默认取值：

默认为ADD。

instance_number

否

Integer

参数解释：

操作实例个数。

约束限制：

配置参数时，instance_number和instance_percentage参数只能选其中一个进行配置。

取值范围：

• operation为SET时，取值范围为：0~300。
• operation为ADD或REMOVE/REDUCE时，取值范围为：1~300。

默认取值：

默认为1。

instance_percentage

否

Integer

参数解释：

操作实例百分比，将伸缩组容量增加、减少或设置为伸缩组当前实例个数的百分比。

配置参数时，instance_number和instance_percentage参数只能选其中一个进行配置。

约束限制：

• 当instance_number和instance_percentage参数均无配置时，则操作实例个数为1。
• 配置参数时，instance_number和instance_percentage参数只能选其中一个进行配置。

取值范围：

• 操作为ADD或REMOVE/REDUCE时取值范围为1到20000的整数。
• 操作为SET时取值范围为0到20000的整数。

默认取值：

不涉及

scaling_policy_id

String

参数解释：

伸缩策略ID

取值范围：

不涉及