创建弹性伸缩策略（V2版本） - CreateScalingV2Policy

project_id

是

String

参数解释：

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

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

scaling_policy_name

是

String

参数解释：

伸缩策略名称。

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

scaling_resource_id

是

String

参数解释：

伸缩资源ID，伸缩组唯一标识或带宽唯一标识。伸缩组ID可通过查询弹性伸缩组列表 - ListScalingGroups获取，带宽ID可通过查询带宽列表获取。

• 如果scaling_resource_type为SCALING_GROUP，对应伸缩组唯一标识即伸缩组ID。
• 如果scaling_resource_type为BANDWIDTH，对应带宽唯一标识即带宽ID。

约束限制：

弹性伸缩不支持对包年包月的带宽进行调整。

取值范围：

不涉及

默认取值：

不涉及

scaling_resource_type

是

string

参数解释：

伸缩资源类型

约束限制：

不涉及

取值范围：

• 伸缩组：SCALING_GROUP
• 带宽：BANDWIDTH

默认取值：

不涉及

scaling_policy_type

是

String

参数解释：

策略类型

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

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字段数据结构说明。

约束限制：

不涉及

interval_alarm_actions

否

Array of interval_alarm_actions objects

参数解释：

伸缩策略告警区间，详情请见表 interval_alarm_actions字段数据结构说明。

约束限制：

当scaling_policy_type为INTERVAL_ALARM时，该参数生效且必填。

cool_down_time

否

Integer

参数解释：

冷却时间，单位是秒。

约束限制：

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

取值范围：

0-86400秒。

默认取值：

300

description

否

String

参数解释：

伸缩策略描述。

约束限制：

不涉及

取值范围：

1-256个字符

默认取值：

不涉及

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时该项必选。
• 当recurrence_type类型为Daily时，recurrence_value参数不生效。

取值范围：

• 类型为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。

size

否

Integer

参数解释：

操作大小。

约束限制：

• 只有操作为SET时取值可以为0，其余操作取值均不能为0。
• 当scaling_resource_type为SCALING_GROUP时，size和percentage参数只能选其中一个进行配置。

取值范围：

• 当scaling_resource_type为SCALING_GROUP时，size为实例个数，取值范围为0到300的整数，默认为1。
• 当scaling_resource_type为BANDWIDTH时，size表示带宽大小，单位为Mbit/s，取值范围为1到300的整数，默认为1。

默认取值：

默认为1。

percentage

否

Integer

参数解释：

操作百分比。

约束限制：

• 当scaling_resource_type为SCALING_GROUP时，size和percentage参数只能选其中一个进行配置，如果size和percentage参数均无配置，则size默认为1。
• 当scaling_resource_type为BANDWIDTH时，不支持配置percentage参数。

取值范围：

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

默认取值：

默认为1。

limits

否

Integer

参数解释：

操作限制。

• 当operation为ADD时，limits表示带宽可调整的上限；
• 当operation为REDUCE时，limits表示带宽可调整的下限。

约束限制：

当scaling_resource_type为BANDWIDTH，且operation不为SET时，limits参数生效，单位为Mbit/s。

取值范围：

不涉及

默认取值：

不涉及

lower_bound

否

double

参数解释：

区间下限。

约束限制：

• 区间下限为空时，区间上限必须小于等于0。
• 区间下限最小值为-1.174271E108。

取值范围：

不涉及

默认取值：

默认为空。

upper_bound

否

double

参数解释：

区间上限。

约束限制：

• 区间上限为空时，区间下限必须大于等于0。
• 区间上限最大值为1.174271E108。

取值范围：

不涉及

默认取值：

默认为空。

operation

否

String

参数解释：

操作选项。

约束限制：

不涉及

取值范围：

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

默认取值：

默认为ADD。

size

否

Integer

参数解释：

操作大小。

约束限制：

• 只有操作为SET时，取值可以为0，其余操作取值均不能为0。
• 当scaling_resource_type为SCALING_GROUP时，size和percentage参数只能选其中一个进行配置。

取值范围：

• 当scaling_resource_type为SCALING_GROUP时，size为实例个数，取值范围为0到300的整数，默认为1。
• 当scaling_resource_type为BANDWIDTH时，size表示带宽大小，单位为Mbit/s，取值范围为1到300的整数，默认为1。

默认取值：

默认为1。

percentage

否

Integer

参数解释：

操作百分比。

约束限制：

• 当scaling_resource_type为SCALING_GROUP时，size和percentage参数只能选其中一个进行配置，若size和percentage参数均无配置，则size默认为1。
• 当scaling_resource_type为BANDWIDTH时，不支持配置percentage参数。

取值范围：

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

默认取值：

不涉及

limits

否

Integer

参数解释：

操作限制。

• 当operation为ADD时，limits表示带宽可调整的上限；

• 当operation为REDUCE时，limits表示带宽可调整的下限。

约束限制：

当scaling_resource_type为BANDWIDTH，且operation不为SET时，limits参数生效，单位为Mbit/s。

取值范围：

不涉及

默认取值：

不涉及

scaling_policy_id

String

参数解释：

伸缩策略ID

取值范围：

不涉及