全部產品
Search
文件中心

Container Service for Kubernetes:nodepool

更新時間:Jun 25, 2026

名稱

類型

描述

樣本值

object

節點池。

auto_scaling

object

自動伸縮節點池配置。

enable

boolean

是否啟用自動伸縮。

  • true:開啟節點池自動伸縮功能。

  • false:不開啟自動伸縮,當取值為 false 時,auto_scaling內的其他配置參數將不生效。

預設值:false

true

max_instances

integer

自動伸縮組最大實例數。

10

min_instances

integer

自動伸縮組最小實例數。

0

type

string

自動伸縮類型,按照自動伸縮實例類型劃分。取值:

  • cpu:普通實例型。

  • gpu:GPU 實例型。

  • gpushare:GPU 共享型。

  • spot:搶佔式實例型。

預設值:cpu

cpu

is_bond_eip

boolean

【該欄位已廢棄】

是否繫結 EIP,取值:

  • true:繫結 EIP。

  • false:不繫結 EIP。

預設值:false

true

eip_internet_charge_type

string

【該欄位已廢棄】

EIP 計費類型,取值:

  • PayByBandwidth:按固定頻寬計費。

  • PayByTraffic:按使用流量計費。

預設值:PayByBandwidth。

PayByBandwidth

eip_bandwidth

integer

【該欄位已廢棄】

EIP 頻寬峰值。單位:Mbps。

5

kubernetes_config

object

叢集相關配置。

cms_enabled

boolean

是否在 ECS 節點上安裝雲端監控,安裝後可以在雲端監控主控台檢視所建立 ECS 實例的監控資訊,建議開啟。取值:

  • true:在 ECS 節點上安裝雲端監控。

  • false:不在 ECS 節點上安裝雲端監控。

預設值:false

true

cpu_policy

string

節點 CPU 管理策略。當叢集版本在 1.12.6 及以上時支援以下兩種策略:

  • static:允許為節點上具有某些資源特徵 Pod 增強其 CPU 親和性和獨佔性。

  • none:表示啟用現有的預設 CPU 親和性方案。

預設值:none

none

labels

array

節點標籤,為 Kubernetes 叢集節點新增標籤。

tag

節點標籤。

runtime

string

容器運行時。取值:

  • containerd:建議使用,支援所有叢集版本。

  • Sandboxed-Container.runv:安全沙箱容器,提供更高的隔離性,支援 1.24 版本及以下叢集。

  • docker:支援 1.22 版本及以下叢集。

預設值:containerd

containerd

runtime_version

string

容器運行時版本。

1.6.20

taints

array

污點配置。

taint

污點配置。

user_data

string

節點自訂資料。

MXM=

node_name_mode

string

節點名稱由三部分組成:前綴 + 節點 IP + 後綴:

  • 前綴和後綴均可由"."分隔的一個或多個部分構成,每個部分可以使用小寫字母、數字和"-",節點名稱首尾必須為小寫字母和數字;

  • 節點 IP 為完整的節點私網 IP 位址;

傳參包含四個部分,由逗號分隔,例如:參數傳入"customized,aliyun,ip,com"字串(其中"customized"和"ip"為固定的字串,aliyun 為前綴,com 為後綴),則節點的名稱為:aliyun.192.168.xxx.xxx.com。

customized,aliyun,ip,com

nodepool_info

object

節點池配置。

name

string

節點池名稱。

np-test

resource_group_id

string

節點池所在資源 ID。

rg-acfmyvw3wjm****

type

string

節點池類型,取值範圍:

  • ess:節點池。

  • edge:邊緣節點池。

ess

scaling_group

object

節點池擴容組配置。

auto_renew

boolean

節點池是否開啟自動續費,當instance_charge_type取值為PrePaid時才生效,取值:

  • true:自動續費。

  • false:不自動續費。

預設值:true

false

auto_renew_period

integer

節點池自動續費週期。當instance_charge_type取值為PrePaid時才生效,且為必選值。

PeriodUnit=Month時,取值範圍:{1, 2, 3, 6, 12}。

預設值:1。

0

data_disks

array

節點池節點資料磁碟配置。

data_disk

節點池節點資料磁碟配置。

disk_init

array

區塊裝置初始化配置。

DiskInit

DiskInit 配置。

image_id

string

自訂映像 ID,預設使用系統提供的映像。

aliyun_2_1903_x64_20G_alibase_20200904.vhd

instance_charge_type

string

節點池節點付費類型,取值:

  • PrePaid:預付費。

  • PostPaid:隨用隨付。

預設值:PostPaid

PostPaid

instance_types

array

實例規格。

string

實例規格。

ecs.n1.medium

key_pair

string

金鑰對名稱,和login_password二選一。

說明

如果建立託管節點池,則只支援key_pair

np-key

login_password

string

SSH 登入密碼,和key_pair二選一。密碼規則為 8~30 個字元,且至少同時包含三項(大小寫字母、數字和特殊符號)。

Hello1234

login_as_non_root

boolean

彈出的 ECS 實例是否使用以非 root 使用者登入。

period

integer

節點池節點包年包月時長,當instance_charge_type取值為PrePaid時才生效且為必選值,取值範圍:period_unit取值為 Month 時,period取值範圍:{ 1, 2, 3, 6, 12}。

預設值:1。

0

period_unit

string

節點池節點付費週期,當instance_charge_type取值為PrePaid時需要指定週期。

Month:目前只支援以月為單位。

Month

platform

string

作業系統發行版。取值:

  • CentOS

  • AliyunLinux

  • Windows

  • WindowsCore

預設值:AliyunLinux

AliyunLinux

rds_instances

array

RDS 實例列表。

string

RDS 實例 ID。

rm-2zey3t89t6280****

spot_strategy

string

搶佔式實例類型,取值:

  • NoSpot:非搶佔式實例。

  • SpotWithPriceLimit:設定搶佔實例價格上限。

  • SpotAsPriceGo:系統自動出價,跟隨當前市場實際價格。

更多資訊,請參見搶佔式實例

NoSpot

spot_price_limit

array

當前單台搶佔式實例規格市場價格區間配置。

object

instance_type

string

抢占式实例规格。

ecs.c6.large

price_limit

string

单台实例上限价格。

0.39

scaling_policy

string

伸縮組模式,取值:

  • release:標準模式,根據申請資源值的使用量,透過建立、釋放 ECS 的方式進行伸縮。

  • recycle:極速模式,透過建立、停機、啟動的方式進行伸縮,提高再次伸縮的速度(停機時運算資源不收費,只收取儲存費用,本機磁碟機型除外)。

預設值:release

release

security_group_id

string

節點池安全群組 ID,與security_group_ids二選一,建議使用security_group_ids

sg-2zeihch86ooz9io4****

security_group_ids

array

安全群組 ID 列表,與security_group_id二選一,建議使用security_group_ids,當同時指定security_group_idsecurity_group_ids將優先使用security_group_ids

string

安全群組 ID。

sg-2zeihch86ooz9io4****

system_disk_category

string

節點系統磁碟類型,取值:

  • cloud_efficiency:高效雲端磁碟。

  • cloud_ssd:SSD 雲端磁碟。

  • cloud_essd:ESSD 雲端磁碟。

  • cloud_auto:ESSD AutoPL 雲端磁碟。

  • cloud_essd_entry:ESSD Entry 雲端磁碟。

預設值:cloud_efficiency

cloud_efficiency

system_disk_categories

array

系統磁碟的多磁碟類型。當無法使用高優先順序的磁碟類型時,自動嘗試下一優先順序的磁碟類型建立系統磁碟。取值範圍:

  • cloud:普通雲端磁碟。

  • cloud_efficiency:高效雲端磁碟。

  • cloud_ssd:SSD 雲端磁碟。

  • cloud_essd:ESSD 雲端磁碟。

string

節點系統磁碟類型。

cloud_essd

system_disk_size

integer

節點系統磁碟大小,單位:GiB。

取值範圍:[40,500]。

120

system_disk_performance_level

string

節點系統磁碟效能,只對 ESSD 磁碟生效。

  • PL0:並行極限 I/O 效能中等,讀寫延遲較為穩定。

  • PL1:並行極限 I/O 效能中等,讀寫延遲較為穩定。

  • PL2:並行極限 I/O 效能較高,讀寫延遲穩定。

  • PL3:並行極限 I/O 效能極高,讀寫延遲極穩定。

PL1

system_disk_encrypted

boolean

是否加密系統磁碟。取值範圍:true:加密。false:不加密。

system_disk_kms_key_id

string

節點系統磁碟使用的 KMS 金鑰 ID。

0e478b7a-4262-4802-b8cb-00d3fb40****

system_disk_encrypt_algorithm

string

節點系統磁碟採用的加密演算法。取值範圍:aes-256。

aes-256

system_disk_provisioned_iops

integer

節點系統磁碟預配置的讀寫 IOPS。可能值:0~min{50,000, 1000*容量-基準效能}。 基準效能=min{1,800+50*容量, 50000}。

SystemDiskCategorycloud_auto時才支援設定該參數。更多資訊,請參見ESSD AutoPL 雲端磁碟

1000

system_disk_bursting_enabled

boolean

節點系統磁碟是否開啟 Burst(效能突發)。 取值:

  • true:是。

  • false:否。

SystemDiskCategory取值為cloud_auto時才支援設定該參數。更多資訊,請參見ESSD AutoPL 雲端磁碟

true

tags

array

僅為 ECS 實例新增標籤。

標籤鍵不可以重複,最大長度為 128 個字元;標籤鍵和標籤值都不能以"aliyun"、"acs:"開頭,或包含"https://"、"http://"。

object

key

string

标签的名称。

key

value

string

标签值。

value

vswitch_ids

array

虛擬交換器 ID。

string

虛擬交換器 ID。

vsw-2ze0fmpbwo140ahni****

multi_az_policy

string

多可用區伸縮組 ECS 實例擴縮容策略。取值:

  • PRIORITY:根據您定義的虛擬交換器(VSwitchIds.N)擴縮容。當優先順序較高的虛擬交換器所在可用區無法建立 ECS 實例時,自動使用下一優先順序的虛擬交換器建立 ECS 實例。

  • COST_OPTIMIZED:按 vCPU 單價從低到高進行嘗試建立。當伸縮配置設定了搶佔式計費方式的多實例規格時,優先建立對應搶佔式實例。您可以繼續透過CompensateWithOnDemand參數指定當搶佔式實例由於庫存等原因無法建立時,是否自動嘗試以隨用隨付的方式建立。

    說明

    COST_OPTIMIZED僅在伸縮配置設定了多實例規格或者選用了搶佔式實例的情況下生效。

  • BALANCE:在伸縮組指定的多可用區之間均勻分配 ECS 實例。如果由於庫存不足等原因可用區之間變得不平衡,您可以透過 API RebalanceInstances 平衡資源。更多資訊,請參見 RebalanceInstances

預設值:PRIORITY

COST_OPTIMIZED

on_demand_base_capacity

integer

伸縮組所需要隨用隨付實例個數的最小值,取值範圍:[0,1000]。當隨用隨付實例個數少於該值時,將優先建立隨用隨付實例。

0

on_demand_percentage_above_base_capacity

integer

伸縮組滿足最小隨用隨付實例數(on_demand_base_capacity)要求後,超出的實例中隨用隨付實例應佔的比例。取值範圍:[0,100]。

20

spot_instance_pools

integer

指定可用實例規格的個數,伸縮組將按成本最低的多個規格均衡建立搶佔式實例。取值範圍:[1,10]。

5

spot_instance_remedy

boolean

是否開啟補齊搶佔式實例。開啟後,當收到搶佔式實例將被回收的系統訊息時,伸縮組將嘗試建立新的實例,替換掉將被回收的搶佔式實例。取值:

  • true:開啟補齊搶佔式實例。

  • false:不開啟補齊搶佔式實例。

false

compensate_with_on_demand

boolean

multi_az_policy取值為COST_OPTIMIZED時,如果因價格、庫存等原因無法建立足夠的搶佔式實例,是否允許自動嘗試建立隨用隨付實例滿足 ECS 實例數量要求。取值:

  • true:允許自動嘗試建立隨用隨付實例滿足 ECS 實例數量要求。

  • false:不允許自動嘗試建立隨用隨付實例滿足 ECS 實例數量要求。

true

internet_charge_type

string

公網 IP 收費類型。取值:

  • PayByBandwidth:按固定頻寬計費。

  • PayByTraffic:按使用流量計費。

PayByBandwidth

internet_max_bandwidth_out

integer

節點公網 IP 出頻寬最大值,單位為 Mbps(Mega bit per second),取值範圍:[1,100]

10

image_type

string

作業系統映像類型,和 platform 參數二選一,取值範圍:

  • AliyunLinux:Alinux2 映像。

  • AliyunLinux3:Alinux3 映像。

  • AliyunLinux3Arm64:Alinux3 映像 ARM 版。

  • AliyunLinuxUEFI:Alinux2 映像 UEFI 版。

  • CentOS:CentOS 映像。

  • Windows:Windows 映像。

  • WindowsCore:WindowsCore 映像。

  • ContainerOS:容器最佳化映像。

AliyunLinux

deploymentset_id

string

部署集 ID。

ds-bp1d19mmbsv3jf6xxxxx

desired_size

integer

節點池期望節點數量。

2

private_pool_options

object

私有節點池配置。

id

string

私有节点池 ID。

eap-bp67acfmxazb4****

match_criteria

string

私有节点池类型,实例启动的私有池容量选项。弹性保障服务或容量预定服务在生效后会生成私有池容量,供实例启动时选择。取值:

  • Open:开放模式。将自动匹配开放类型的私有池容量。如果没有符合条件的私有池容量,则使用公共池资源启动。

  • Target:指定模式。使用指定的私有池容量启动实例,如果该私有池容量不可用,则实例会启动失败。

  • None:不使用模式。实例启动将不使用私有池容量。

Open

ram_role_name

string

Worker RAM 角色名稱。

重要 僅 1.22 及以上版本的 ACK 託管叢集支援在建立節點池時配置該參數

example-role

instance_metadata_options InstanceMetadataOptions

ECS 實例的中繼資料存取配置。 目前僅白名單開放,需提交工單申請。

resource_pool_options

object

建立實例時使用的資源池及資源池策略。當您設定該參數後,需要注意: 該參數只在建立隨用隨付實例時生效。 該參數不能與 private_pool_options.match_criteria、private_pool_options.id 同時設定。

strategy

string

创建实例时使用的资源池策略。资源池包括弹性保障服务或容量预定服务生效后生成的私有池以及公共池,供实例启动时选择。取值范围: PrivatePoolFirst:私有池优先。选择此种策略时, 当指定了 resource_pool_options.private_pool_ids,优先使用指定的私有池。如果未指定私有池或指定的私有池容量不足,将自动匹配开放类型的私有池。如果没有符合条件的私有池,则使用公共池创建实例。 PrivatePoolOnly:仅限私有池。选择此种策略时,必须指定 resource_pool_options.private_pool_ids。如果指定的私有池容量不足,则实例会启动失败。 None:不使用资源池策略。 默认值:None。

PrivatePoolFirst

private_pool_ids

array

私有池 ID 列表。即弹性保障服务 ID 或容量预定服务 ID。该参数只能传入 Target 模式私有池 ID。N 的取值范围:1~20。

string

私有池 ID。即弹性保障服务 ID 或容量预定服务 ID。该参数只能传入 Target 模式私有池 ID。

eap-bp67acfmxazb4****

tee_config

object

加密運算節點池配置。

tee_enable

boolean

是否為加密運算節點池。

false

management

object

託管節點池配置。

enable

boolean

是否開啟託管版節點池,取值:

  • true:開啟託管節點池。

  • false:不開啟託管節點池,只有當enable=true時,其他相關配置才生效。

false

auto_repair

boolean

自動修復,僅當enable=true時生效。

  • true:自動修復。

  • false:不自動修復。

false

upgrade_config

object

自動升級配置,僅當enable=true時生效。

auto_upgrade

boolean

是否启用自动升级,取值:

  • true:启用自动升级。

  • false:不启用自动升级。

false

surge

integer

额外节点数量。

0

surge_percentage

integer

额外节点比例,和surge二选一。

0

max_unavailable

integer

最大不可用节点数量,取值范围:[1,1000]。

默认值:1。

0

auto_repair_policy

object

自動修復節點策略。

restart_node

boolean

是否允许重启节点。

true

auto_vul_fix

boolean

是否自動修復 CVE。

true

auto_vul_fix_policy

object

自動修復 CVE 策略。

restart_node

boolean

是否允许重启节点。

true

vul_level

string

允许自动修复的漏洞级别,以逗号分隔。

asap,nntf

auto_upgrade

boolean

是否自動升級。

true

auto_upgrade_policy

object

自動升級策略。

auto_upgrade_kubelet

boolean

是否允许自动升级 kubelet。

true

auto_fault_diagnosis

boolean

count

integer

【該欄位已廢棄,請使用 desired_size 代替】

節點池節點數量。

1

interconnect_mode

string

邊緣節點池的網路類型,該值只對typeedge類型的節點池有意義,取值範圍:

  • basic:基礎型。

  • private: 專用型。1.22 及以上版本支援。

basic

interconnect_config

object

【該欄位已廢棄】

邊緣節點池配置。

cen_id

string

【該欄位已廢棄】

邊緣增強型節點池繫結的雲端企業網實例 ID(CENID)。

cen-ey9k9nfhz0f*******

ccn_id

string

【該欄位已廢棄】

邊緣增強型節點池繫結的雲端連接網實例 ID(CCNID)。

ccn-qm5i0i0q9yi*******

ccn_region_id

string

【該欄位已廢棄】

邊緣增強型節點池繫結的雲端連接網實例所屬的地區。

cn-shanghai

bandwidth

integer

【該欄位已廢棄】

邊緣增強型節點池的網路頻寬,單位:Mbps。

10

improved_period

string

【該欄位已廢棄】

邊緣增強型節點池的購買時長,單位:月。

1

max_nodes

integer

邊緣節點池允許容納的最大節點數量,該參數大於等於 0。0 表示無額外限制(僅受限於叢集整體可以容納的節點數,節點池本身無額外限制)。邊緣節點池該參數值往往大於 0;ess 類型節點池和預設的 edge 類型節點池該參數值為 0。

10

node_config

object

節點配置。

kubelet_configuration kubelet_config

Kubelet 參數配置。

node_components

array

節點元件列表。

object

節點元件。

name

string

節點元件名稱。

kubelet

version

string

節點元件版本

1.33.3-aliyun.1

config

object

節點元件配置。

custom_config

object

节点组件自定义配置。

{"cpuManagerPolicy":"static"}

any

节点组件自定义配置字符串。

cpuManagerPolicy