弹性伸缩 AS-修改弹性伸缩策略:请求参数

时间:2023-11-01 16:21:46

请求参数

表2 请求参数

参数

是否必选

参数类型

描述

scaling_policy_name

String

伸缩策略名称(1-64个字符),只能包含中文、字母、数字、下划线或中划线。

scaling_policy_type

String

策略类型

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

alarm_id

String

告警ID,即告警规则的ID,当scaling_policy_type为ALARM时该项必选,此时scheduled_policy不生效。

修改成功后,会自动为该告警ID对应的告警规则的alarm_actions字段增加类型为autoscaling的告警触发动作。

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

scheduled_policy

scheduled_policy object

定时、周期任务策略,当scaling_policy_type为SCHEDULED或RECURRENCE时该项必选,此时alarm_id不生效。请参考表 scheduled_policy字段数据结构说明

scaling_policy_action

scaling_policy_action object

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

cool_down_time

Integer

冷却时间,取值范围0-86400,单位是秒。

表3 scheduled_policy字段数据结构说明

参数

是否必选

参数类型

描述

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时间,scaling_policy_type为RECURRENCE时该项必选。

当为周期类型策略时,不得早于当前时间和开始时间

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

表4 scaling_policy_action字段数据结构说明

参数

是否必选

参数类型

描述

operation

String

操作选项,默认为ADD。

  • ADD:增加实例
  • REMOVE/REDUCE:减少实例
  • SET:设置实例数为

instance_number

Integer

操作实例个数,默认为1。当配额为默认配额时,取值范围如下:

  • operation为SET时,取值范围为:0~300。
  • operation为ADD或REMOVE/REDUCE时,取值范围为:1~300。
说明:

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

instance_percentage

Integer

操作实例百分比,将伸缩组容量增加、减少或设置为伸缩组当前实例个数的百分比。操作为ADD或REMOVE/REDUCE时取值范围为1到20000的整数,操作为SET时取值范围为0到20000的整数。

当instance_number和instance_percentage参数均无配置时,则操作实例个数为1。

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

support.huaweicloud.com/api-as/as_06_0403.html