全部產品
Search
文件中心

Container Service for Kubernetes:nodepool

更新時間:Aug 21, 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

instance_patterns

array

執行個體屬性。

instance_patterns

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。

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****

cpu_options

object

CPU 相關設定選項。

nested_virtualization

string

是否開啟巢狀虛擬化。取值:

  • disabled:關閉巢狀虛擬化。

  • enabled:開啟巢狀虛擬化。

enabled

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

max_parallel_repairing_nodes

string

最大平行修復數,節點池中存在大量異常節點時,最多允許同時修復的節點數或節點比例。支援數量(如 5,取值範圍 1~100000)或百分比(如 10%,取值範圍 1%~100%)。後端預設平行修復數:1。

5

max_unhealthy_nodes_threshold

string

自癒熔斷條件,當發生故障的節點數或節點比例大於該閾值時,自癒進入熔斷狀態,並停止新增自癒修復動作。支援數量(如 10,取值範圍 1~100000)或百分比(如 20%,取值範圍 1%~100%)。後端預設熔斷條件為:100%。

20%

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

是否啟用節點自癒 ECS 故障檢測。

drift_enabled

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

envs

array

節點元件環境變數。

object

name

string

環境變數名稱。

LOG_LEVEL

value

string

環境變數值。

info