通用数据结构

enable

Boolean

true

是否启用自动伸缩。

• true：开启节点池自动伸缩功能。
• false：不开启自动伸缩，当取值为false时，auto_scaling内的其他配置参数将不生效。

默认值：false。

max_instances

Long

10

自动伸缩组最大实例数。

min_instances

Long

0

自动伸缩组最小实例数。

type

String

cpu

自动伸缩类型，按照自动伸缩实例类型划分。取值：

• cpu：普通实例型。
• gpu：GPU实例型。
• gpushare：GPU共享型。
• spot：抢占式实例型。

默认值：cpu。

is_bond_eip

Boolean

true

【该字段已废弃】

是否绑定EIP，取值：

• true：绑定EIP。
• false：不绑定EIP。

默认值：false。

eip_internet_charge_type

String

PayByBandwidth

【该字段已废弃】

EIP计费类型，取值：

• PayByBandwidth：按固定带宽计费。
• PayByTraffic：按使用流量计费。

默认值：PayByBandwidth。

eip_bandwidth

Long

5

【该字段已废弃】

EIP带宽峰值。单位：Mbps。

cms_enabled

Boolean

true

是否在ECS节点上安装云监控，安装后可以在云监控控制台查看所创建ECS实例的监控信息，推荐开启。取值：

• true：在ECS节点上安装云监控。
• false：不在ECS节点上安装云监控。

默认值：false。

cpu_policy

String

none

节点CPU管理策略。当集群版本在1.12.6及以上时支持以下两种策略：

• static：允许为节点上具有某些资源特征Pod增强其CPU亲和性和独占性。
• none：表示启用现有的默认CPU亲和性方案。

默认值：none。

runtime

String

containerd

容器运行时。取值：

• containerd：推荐使用，支持所有集群版本。
• Sandboxed-Container.runv：安全沙箱容器，提供更高的隔离性，支持1.24版本及以下集群。
• docker：支持1.22版本及以下集群。

默认值：containerd

runtime_version

String

1.6.20

容器运行时版本。

user_data

String

MXM=

节点自定义数据。

node_name_mode

String

customized,aliyun,ip,com

节点名称由三部分组成：前缀 + 节点 IP + 后缀：

• 前缀和后缀均可由“.”分隔的一个或多个部分构成，每个部分可以使用小写字母、数字和“-”，节点名称首尾必须为小写字母和数字；
• 节点 IP为完整的节点私网 IP 地址；

传参包含四个部分，由逗号分隔，例如：参数传入"customized,aliyun,ip,com"字符串（其中“customized”和"ip"为固定的字符串，aliyun为前缀，com为后缀），则节点的名称为：aliyun.192.168.xxx.xxx.com。

name

String

np-test

节点池名称。

resource_group_id

String

rg-acfmyvw3wjm****

节点池所在资源ID。

type

String

ess

节点池类型，取值范围：

• ess：节点池。
• edge：边缘节点池。

auto_renew

Boolean

false

节点池是否开启自动续费，当instance_charge_type取值为PrePaid时才生效，取值：

• true：自动续费。
• false：不自动续费。

默认值：true。

auto_renew_period

Long

0

节点池自动续费周期。当instance_charge_type取值为PrePaid时才生效，且为必选值。

当PeriodUnit=Month时，取值范围：{1, 2, 3, 6, 12}。

默认值：1。

image_id

String

aliyun_2_1903_x64_20G_alibase_20200904.vhd

自定义镜像ID，默认使用系统提供的镜像。

instance_charge_type

String

PostPaid

节点池节点付费类型，取值：

• PrePaid：预付费。
• PostPaid：按量付费。

默认值：PostPaid。

instance_types

Array of String

ecs.n1.medium

实例规格。

key_pair

String

np-key

密钥对名称，和login_password二选一。

login_password

String

Hello1234

SSH登录密码，和key_pair二选一。密码规则为8~30个字符，且至少同时包含三项（大小写字母、数字和特殊符号）。

period

Long

0

节点池节点包年包月时长，当instance_charge_type取值为PrePaid时才生效且为必选值，取值范围：period_unit取值为Month时，period取值范围：{ 1, 2, 3, 6, 12}。

默认值：1。

period_unit

String

Month

节点池节点付费周期，当instance_charge_type取值为PrePaid时需要指定周期。

Month：目前只支持以月为单位。

platform

String

AliyunLinux

操作系统发行版。取值：

• CentOS
• AliyunLinux
• Windows
• WindowsCore

默认值：AliyunLinux。

rds_instances

Array of String

rm-2zey3t89t6280****

RDS实例ID。

spot_strategy

String

NoSpot

抢占式实例类型，取值：

• NoSpot：非抢占式实例。
• SpotWithPriceLimit：设置抢占实例价格上限。
• SpotAsPriceGo：系统自动出价，跟随当前市场实际价格。

更多信息，请参见抢占式实例。

scaling_policy

String

release

伸缩组模式，取值：

• release：标准模式，根据申请资源值的使用量，通过创建、释放ECS的方式进行伸缩。
• recycle：极速模式，通过创建、停机、启动的方式进行伸缩，提高再次伸缩的速度（停机时计算资源不收费，只收取存储费用，本地盘机型除外）。

默认值：release。

security_group_id

String

sg-2zeihch86ooz9io4****

节点池安全组ID，与security_group_ids二选一，推荐使用security_group_ids。

security_group_ids

Array of String

sg-2zeihch86ooz9io4****

安全组ID。

system_disk_category

String

cloud_efficiency

节点系统盘类型，取值：

• cloud_efficiency：高效云盘。
• cloud_ssd：SSD云盘。
• cloud_essd：ESSD云盘。
• cloud_auto：ESSD AutoPL云盘。

默认值：cloud_efficiency。

system_disk_size

Long

120

节点系统盘大小，单位：GiB。

取值范围：[40,500]。

system_disk_performance_level

String

PL1

节点系统盘磁盘性能，只对ESSD磁盘生效。

• PL0：并发极限I/O性能中等，读写时延较为稳定。
• PL1：并发极限I/O性能中等，读写时延较为稳定。
• PL2：并发极限I/O性能较高，读写时延稳定。
• PL3：并发极限I/O性能极高，读写时延极稳定。

system_disk_provisioned_iops

Long

1000

节点系统盘预配置的读写IOPS。可能值：0~min{50,000, 1000*容量-基准性能}。 基准性能=min{1,800+50*容量, 50000}。

当SystemDiskCategory为cloud_auto时才支持设置该参数。更多信息，请参见ESSD AutoPL云盘。

system_disk_bursting_enabled

Boolean

true

节点系统盘是否开启Burst（性能突发）。 取值：

• true：是。
• false：否。

当SystemDiskCategory取值为cloud_auto时才支持设置该参数。更多信息，请参见ESSD AutoPL云盘。

vswitch_ids

Array of String

vsw-2ze0fmpbwo140ahni****

虚拟交换机ID。

multi_az_policy

String

COST_OPTIMIZED

多可用区伸缩组ECS实例扩缩容策略。取值：

• PRIORITY：根据您定义的虚拟交换机（VSwitchIds.N）扩缩容。当优先级较高的虚拟交换机所在可用区无法创建ECS实例时，自动使用下一优先级的虚拟交换机创建ECS实例。

• COST_OPTIMIZED：按vCPU单价从低到高进行尝试创建。当伸缩配置设置了抢占式计费方式的多实例规格时，优先创建对应抢占式实例。您可以继续通过CompensateWithOnDemand参数指定当抢占式实例由于库存等原因无法创建时，是否自动尝试以按量付费的方式创建。

  说明

  COST_OPTIMIZED仅在伸缩配置设置了多实例规格或者选用了抢占式实例的情况下生效。

• BALANCE：在伸缩组指定的多可用区之间均匀分配ECS实例。如果由于库存不足等原因可用区之间变得不平衡，您可以通过API RebalanceInstances平衡资源。更多信息，请参见RebalanceInstances。

默认值：PRIORITY。

on_demand_base_capacity

Long

0

伸缩组所需要按量实例个数的最小值，取值范围：[0,1000]。当按量实例个数少于该值时，将优先创建按量实例。

on_demand_percentage_above_base_capacity

Long

20

伸缩组满足最小按量实例数（on_demand_base_capacity）要求后，超出的实例中按量实例应占的比例。取值范围：[0,100]。

spot_instance_pools

Long

5

指定可用实例规格的个数，伸缩组将按成本最低的多个规格均衡创建抢占式实例。取值范围：[1,10]。

spot_instance_remedy

Boolean

false

是否开启补齐抢占式实例。开启后，当收到抢占式实例将被回收的系统消息时，伸缩组将尝试创建新的实例，替换掉将被回收的抢占式实例。取值：

• true：开启补齐抢占式实例。
• false：不开启补齐抢占式实例。

compensate_with_on_demand

Boolean

true

当multi_az_policy取值为COST_OPTIMIZED时，如果因价格、库存等原因无法创建足够的抢占式实例，是否允许自动尝试创建按量实例满足ECS实例数量要求。取值：

• true：允许自动尝试创建按量实例满足ECS实例数量要求。
• false：不允许自动尝试创建按量实例满足ECS实例数量要求。

internet_charge_type

String

PayByBandwidth

公网IP收费类型。取值：

• PayByBandwidth：按固定带宽计费。
• PayByTraffic：按使用流量计费。

internet_max_bandwidth_out

Long

10

节点公网IP出带宽最大值，单位为Mbps（Mega bit per second），取值范围：[1,100]

image_type

String

AliyunLinux

操作系统镜像类型，和platform参数二选一，取值范围：

• AliyunLinux：Alinux2镜像。
• AliyunLinux3：Alinux3镜像。
• AliyunLinux3Arm64：Alinux3镜像ARM版。
• AliyunLinuxUEFI：Alinux2镜像UEFI版。
• CentOS：CentOS镜像。
• Windows：Windows镜像。
• WindowsCore：WindowsCore镜像。
• ContainerOS：容器优化镜像。

deploymentset_id

String

ds-bp1d19mmbsv3jf6xxxxx

部署集ID。

desired_size

Long

2

节点池期望节点数量。

tee_enable

Boolean

false

是否为加密计算节点池。

enable

Boolean

false

是否开启托管版节点池，取值：

• true：开启托管节点池。
• false：不开启托管节点池，只有当enable=true时，其他相关配置才生效。

auto_repair

Boolean

false

自动修复，仅当enable=true时生效。

• true：自动修复。
• false：不自动修复。

cen_id

String

cen-ey9k9nfhz0f*******

【该字段已废弃】

边缘增强型节点池绑定的云企业网实例ID(CENID)。

ccn_id

String

ccn-qm5i0i0q9yi*******

【该字段已废弃】

边缘增强型节点池绑定的云连接网实例ID(CCNID)。

ccn_region_id

String

cn-shanghai

【该字段已废弃】

边缘增强型节点池绑定的云连接网实例所属的地域。

bandwidth

Long

10

【该字段已废弃】

边缘增强型节点池的网络带宽，单位：Mbps。

improved_period

String

1

【该字段已废弃】

边缘增强型节点池的购买时长，单位：月。