全部產品
Search
文件中心

Container Service for Kubernetes:DescribeClusterNodePools

更新時間:Jul 15, 2026

查詢叢集內所有節點池列表。

介面說明

  • 移除節點時,請透過本介面或容器服務控制台執行標準化操作。請勿使用kubectl delete node方式手動移除節點。

  • 請勿直接在 ECS 或者 ESS 控制台(或透過相關 API)主動釋放節點、移除執行個體,或因包年包月執行個體到期而被動釋放節點。這些情況下,節點會直接停機,自動從容器服務管理控制台中移除。

  • 如果節點池設定了期望節點數,為了將節點個數始終維持在期望節點數,節點池會根據相應設定自動擴容其他執行個體。

  • 移除節點涉及 Pod 的遷移,可能會影響業務,請在業務離峰期操作。操作過程中可能存在非預期風險,請提前做好相關的資料備份。

  • 移除節點時,ACK 會執行排水操作,請確保叢集其他節點的資源充足,以避免業務 Pod 無法調度。

  • 需檢查待移除節點上的 Pod 的節點親和性規則和調度策略,確保 Pod 不會因為節點移除而無法調度到其他節點。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

cs:DescribeClusterNodePools

get

*Cluster

acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}

請求文法

GET /clusters/{ClusterId}/nodepools HTTP/1.1

路徑參數

名稱

類型

必填

描述

樣本值

ClusterId

string

叢集 ID。

cc0f87de0b8fb403f86e10e204f83****

請求參數

名稱

類型

必填

描述

樣本值

NodepoolName

string

節點池名稱。

nodepool-test

返回參數

名稱

類型

描述

樣本值

object

節點池詳情。

nodepools

array<object>

節點池執行個體列表。

array<object>

節點池執行個體詳情。

nodepool_info

object

節點池資訊。

nodepool_id

string

節點池 ID。

np615c0e0966124216a0412e10afe0****

name

string

節點池名稱。

default-nodepool

type

string

節點池類型。取值:

  • ess:普通節點池(包含託管功能和自動彈性伸縮功能)。

  • edge:邊緣節點池。

  • lingjun:靈駿節點池。

ess

is_default

boolean

是否為預設節點池,通常一個叢集僅有一個預設節點池。取值:

  • true:預設節點池。

  • false:非預設節點池。

true

resource_group_id

string

資源群組 ID。

rg-acfmyvw3wjm****

region_id

string

地域 ID。

cn-beijing

created

string

節點池建立時間。

2025-04-15T16:33:29.362888807+08:00

updated

string

節點池更新時間。

2025-04-15T16:33:32.823+08:00

status

object

節點池狀態。

state

string

節點池狀態,取值:

  • active:已啟用。

  • scaling:伸縮中。

  • removing:節點移除中。

  • deleting:刪除中。

  • updating:更新中。

active

healthy_nodes

integer

處於健康狀態執行個體數。

3

initial_nodes

integer

正在建立的節點數。

0

failed_nodes

integer

失敗執行個體數。

0

offline_nodes

integer

離線節點數。

0

removing_nodes

integer

正在被移除的節點數。

0

serving_nodes

integer

處於工作狀態的節點數。

3

total_nodes

integer

節點池內節點數量。

3

auto_scaling

object

自動伸縮設定。

enable

boolean

是否啟用自動伸縮,取值:

  • true:開啟節點池自動伸縮功能。當叢集的容量規劃無法滿足應用程式 Pod 排程時,ACK 會根據設定的最小和最大執行個體數自動擴縮節點資源。1.24 及以上版本的叢集預設啟用節點即時彈性; 1.24 以下版本的叢集預設啟用節點自動伸縮。更多資訊,請參見節點伸縮

  • false:不開啟自動伸縮,ACK 會根據設定的期望節點數調整節點池中的節點數,將節點數始終維持在期望節點數。

當取值為 false 時,auto_scaling內的其他設定參數將不生效。

true

type

string

自動伸縮類型,按照自動伸縮執行個體類型劃分。取值:

  • cpu:普通執行個體型。

  • gpu:GPU 執行個體型。

  • gpushare:GPU 共用型。

  • spot:搶占式執行個體型。

cpu

max_instances

integer

節點池中可伸縮的最大執行個體數,不包含您已有的執行個體。

10

min_instances

integer

節點池中可伸縮的最小執行個體數,不包含您已有的執行個體。

2

eip_internet_charge_type

string

EIP 計費類型,取值:

  • PayByBandwidth:按固定頻寬計費。

  • PayByTraffic:按使用流量計費。

PayByBandwidth

is_bond_eip

boolean

是否綁定 EIP,取值:

  • true:綁定 EIP。

  • false:不綁定 EIP。

true

eip_bandwidth

integer

EIP 頻寬峰值。

取值範圍:[1,100],單位:Mbps。

5

management

object

託管節點池設定,當前只在專業託管叢集中生效。

enable

boolean

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

  • true:開啟託管節點池。

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

true

auto_repair

boolean

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

  • true:自動修復。

  • false:不自動修復。

true

auto_repair_policy

object

自動修復節點策略。

restart_node

boolean

是否允許重新啟動節點。僅當auto_repair=true時生效。

  • true:允許重新啟動節點。

  • false:不允許重新啟動節點。

true

approval_required

boolean

節點修復是否需要人工審批。

false

auto_repair_policy_id

string

自動修復策略的 ID。

r-xxxxxxxxx

auto_vul_fix

boolean

是否自動修復 CVE。僅當enable=true時生效。

  • true:允許自動修復 CVE。

  • false:不允許自動修復 CVE。

true

auto_vul_fix_policy

object

自動修復 CVE 策略。

restart_node

boolean

是否允許重新啟動節點,僅當auto_vul_fix=true時生效。取值:

  • true:允許重新啟動節點。

  • false:不允許重新啟動節點。

true

vul_level

string

允許自動修復的漏洞層級,以逗號分隔。

  • asap:高

  • later:中

  • nntf:低

asap,nntf

exclude_packages

string

指定在漏洞修復過程中應排除的套件。

kernel

auto_upgrade

boolean

是否自動升級節點,僅當enable=true時生效。

  • true:啟用自動升級。

  • false:不啟用自動升級。

true

auto_upgrade_policy

object

自動升級策略。

auto_upgrade_kubelet

boolean

是否允許自動升級 kubelet,僅當auto_upgrade=true時生效。取值:

  • true:允許自動升級 kubelet。

  • false:不允許自動升級 kubelet。

true

upgrade_config

object

自動升級設定,僅當enable=true時生效。

auto_upgrade

boolean

是否啟用自動升級,取值:

  • true:啟用自動升級。

  • false:不啟用自動升級。

true

surge

integer

額外節點數量。和surge_percentage二選一。

5

surge_percentage

integer

額外節點數的百分比,和surge二選一。

額外節點數=額外節點數比例×節點數,例如,設定額外節點數比例為 50%,存在的節點數為 6,那麼將產生的額外節點數=50%×6,也就是將產生 3 個額外節點數。

50

max_unavailable

integer

最大不可用節點數量,取值範圍:[1,1000]

預設值:1。

1

auto_fault_diagnosis

boolean

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

drift_enabled

boolean

scaling_group

object

節點池伸縮群組設定。

scaling_group_id

string

伸縮群組 ID。

asg-2ze8n5qw4atggut8****

vswitch_ids

array

虛擬交換器 ID 列表。

string

虛擬交換器 ID。

vsw-2ze3ds0mdip0hdz8i****

instance_types

array

節點執行個體規格列表,您可以選擇多個執行個體規格作為備選,每個節點建立時,將從第一個規格開始嘗試購買,直到建立成功。最終購買的執行個體規格可能隨庫存變化而不同。

ecs.n4.large

string

節點執行個體規格。

ecs.n4.large

instance_charge_type

string

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

  • PrePaid:預付費。

  • PostPaid:按量付費。

PostPaid

period

integer

節點包年包月時長,當instance_charge_type取值為PrePaid時才生效且為必選值。

  • period_unit=Week時,period取值範圍:{ 1、2、3、4}。

  • period_unit=Month時,period 取值範圍:{1、2、3、4、5、6、7、8、9、12、24、36、48、60}。

1

period_unit

string

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

  • Month:以月為計時單位。

  • Week:以周為計算單位。

Month

auto_renew

boolean

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

  • true:自動續費。

  • false:不自動續費。

false

auto_renew_period

integer

單次自動續費的續費時長。取值範圍:

  • PeriodUnit=Week 時:1、2、3。

  • PeriodUnit=Month 時:1、2、3、6、12、24、36、48、60。

0

spot_strategy

string

搶占式執行個體類型,取值:

  • NoSpot:非搶占式執行個體。

  • SpotWithPriceLimit:設定搶占執行個體價格上限。

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

更多資訊,請參見搶占式執行個體

NoSpot

spot_price_limit

array<object>

搶占式執行個體市場價格區間設定。

object

搶占執行個體市場價格區間設定,可為不同執行個體規格設定不同的價格區間。

instance_type

string

搶占式執行個體規格。

ecs.c6.large

price_limit

string

單台執行個體市場價格區間。

單位:美元/時。

0.39

image_type

string

作業系統映像類型。

  • AliyunLinux:Alinux2 映像。

  • AliyunLinuxSecurity:Alinux2 映像 UEFI 版。

  • AliyunLinux3:Alinux3 映像。

  • AliyunLinux3Arm64:Alinux3 映像 ARM 版。

  • AliyunLinux3Security:Alinux3 映像 UEFI 版。

  • CentOS:CentOS 映像。

  • Windows:Windows 映像。

  • WindowsCore:WindowsCore 映像。

  • ContainerOS:容器最佳化映像。

  • AliyunLinux3ContainerOptimized: Alinux3 映像容器最佳化版。

AliyunLinux3

image_id

string

自訂映像 ID,可透過DescribeKubernetesVersionMetadata查詢系統支援的映像。

aliyun_3_x64_20G_alibase_20241218.vhd

system_disk_category

string

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

  • cloud_efficiency:高效雲端硬碟。

  • cloud_ssd:SSD 雲端硬碟。

  • cloud_essd:ESSD 雲端硬碟。

  • cloud_auto:ESSD AutoPL 雲端硬碟。

  • cloud_essd_entry:ESSD Entry 雲端硬碟。

cloud_efficiency

system_disk_categories

array

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

string

節點系統磁碟類型。

取值:

  • cloud_efficiency:高效雲端硬碟。

  • cloud_ssd:SSD 雲端硬碟。

  • cloud_essd:ESSD 雲端硬碟。

  • cloud_auto:ESSD AutoPL 雲端硬碟。

  • cloud_essd_entry:ESSD Entry 雲端硬碟。

EESSD云盘

system_disk_size

integer

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

取值範圍:[20,2048]。

120

system_disk_performance_level

string

節點系統磁碟磁碟效能,只對 ESSD 磁碟生效。磁碟效能等級和磁碟大小有關。更多資訊,請參見 ESSD 雲端硬碟

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

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

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

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

PL1

system_disk_encrypted

boolean

是否加密系統磁碟。取值:

  • true:加密。

  • false:不加密。

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_bursting_enabled

boolean

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

  • true:開啟。開啟後,波動性業務面臨突發的資料讀寫壓力時,雲端硬碟會根據業務實際情況臨時提升雲端硬碟效能,直至業務恢復至平穩狀態。

  • false:不開啟。

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

true

system_disk_provisioned_iops

integer

節點系統磁碟預配置的讀寫 IOPS,磁碟類型為 cloud_auto 時設定。

1000

data_disks

array

節點資料磁碟類型、大小等設定的組合。

data_disk

節點資料磁碟設定。

disk_init

array

區塊裝置初始化設定。

DiskInit

DiskInit 設定。

security_group_ids

array

節點池安全性群組 ID 列表。

string

節點池安全性群組 ID 列表。

sg-2ze1iuk12m2sb4c4****

key_pair

string

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

當節點池為託管版節點池時,只支援key_pair

pro-nodepool

login_password

string

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

出於安全性考慮,密碼查詢結果經過加密處理。

******

login_as_non_root

boolean

彈出的 ECS 執行個體是否使用以非 root 使用者登入。

  • true:以非 root 使用者(ecs-user)登入。

  • false:以 root 使用者登入。

true

cis_enabled deprecated

boolean

【該欄位已廢棄】

請使用參數 security_hardening_os 替代。

false

soc_enabled

boolean

是否開啟等保加固,僅當系統映像選擇 Alibaba Cloud Linux 2 或 Alibaba Cloud Linux 3 時,可為節點開啟等保加固。阿里雲為 Alibaba Cloud Linux 2 和 Alibaba Cloud Linux 3 等保 2.0 三級版映像提供等保合規的基線檢查標準和掃描程式。

false

security_hardening_os

boolean

阿里雲 OS 安全加固。取值:

  • true:開啟阿里雲 OS 安全加固。

  • false:不開啟阿里雲 OS 安全加固。

預設值:false

false

internet_charge_type

string

節點公網 IP 網路計費類型。

  • PayByBandwidth:按固定頻寬計費。

  • PayByTraffic:按使用流量計費。

PayByBandwidth

internet_max_bandwidth_out

integer

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

10

tags

array

ECS 執行個體標籤。

tag

節點標籤。

[{\"key\":\"pkg.E2EClient.ClusterId\",\"value\":\"troopers-\"}]

desired_size

integer

節點池期望節點數。

2

multi_az_policy

string

多可用區伸縮群組 ECS 執行個體擴縮容策略。取值:

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

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

    說明

    COST_OPTIMIZED僅在伸縮設定設定了多執行個體規格或者選用了搶占式執行個體的情況下生效。

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

COST_OPTIMIZED

scaling_policy

string

伸縮群組模式,取值:

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

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

release

on_demand_base_capacity

integer

伸。

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

deploymentset_id

string

部署集 ID。

ds-bp1d19mmbsv3jf6xxxxx

rds_instances

array

如果指定了 RDS 实例列表,集群节点 ECS 会自动加入 RDS 访问白名单。

string

RDS 实例。

rm-xxx

private_pool_options

object

私有池选项。

id

string

私有池 ID。即弹性保障服务 ID 或容量预定服务 ID。

eap-bp67acfmxazb4****

match_criteria

string

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

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

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

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

Open

security_group_id

string

【该字段已废弃】

节点池安全组 ID,当节点池绑定多个安全组时,为security_group_ids中的第一个值。

sg-2ze1iuk12m2sb4c4****

platform

string

【该字段已废弃】

操作系统发行版。取值:

  • CentOS

  • AliyunLinux

  • Windows

  • WindowsCore

AliyunLinux

ram_policy

string

该字段已废弃,请使用 ram_role_name 替代。

KubernetesWorkerRole-021dc54f-929b-437a-8ae0-34c24d3e****

instance_patterns

array

实例属性配置。

instance_patterns

实例属性。

ram_role_name

string

Worker RAM 角色名称。

KubernetesWorkerRole-4a4fa089-80c1-48a5-b3c6-9349311f****

resource_pool_options

object

创建实例时使用的资源池及资源池策略。

strategy

string

创建实例时使用的资源池策略。取值范围: PrivatePoolFirst:私有池优先。 PrivatePoolOnly:仅限私有池。 None:不使用资源池策略。

PrivatePoolFirst

private_pool_ids

array

私有池 ID 列表。

string

私有池 ID。

eap-bp1c1fohub5jccwi****

system_disk_snapshot_policy_id

string

系统盘快照策略

sp-0jl6xnmme8v7o935****

node_config

object

节点配置。

kubelet_configuration kubelet_config

Kubelet 参数配置。

node_os_config

object

节点操作系统配置。

hugepage

Hugepage

Hugepage 配置。

kubernetes_config

object

集群相关配置。

labels

array

節點標籤。

tag

标签配置。

{}

taints

array

节点污点信息。污点和容忍度(Toleration)相互配合,可以用来避免 Pod 被分配到不合适的节点上。更多信息,请参见taint-and-toleration

taint

节点污点信息。

runtime

string

容器运行时名称,ACK 支持以下三种容器运行时。

  • containerd:推荐使用,支持所有集群版本。

  • Sandboxed-Container.runv:安全沙箱容器,提供更高的隔离性,支持 1.31 及以下版本集群。

  • docker:已停止维护,支持 1.22 及以下版本集群。

containerd

runtime_version

string

容器运行时版本。

1.6.38

cpu_policy

string

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

  • static:允许为节点上具有某些资源特征 Pod 增强其 CPU 亲和性和独占性。

  • none:表示启用现有的默认 CPU 亲和性方案。

none

user_data

string

节点池自定义数据,即运行于节点初始化之后的脚本。更多详情,请参见生成实例自定义数据

IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD****

unschedulable

boolean

扩容后的节点是否不可调度。

  • true:不可调度。

  • false:可调度。

true

cms_enabled

boolean

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

  • true:在 ECS 节点上安装云监控。

  • false:不在 ECS 节点上安装云监控

true

node_name_mode

string

自定义节点名称。

节点名称由三部分组成:前缀 + 节点 IP 地址子串 + 后缀:

  • 前缀和后缀均可由“.”分隔的一个或多个部分构成,每个部分可以使用小写字母、数字和“-”,节点名称首尾必须为小写字母和数字。

  • IP 地址段长度指截取节点 IP 地址末尾的位数,取值范围 5-12。

例如,节点 IP 地址为:192.168.0.55,指定前缀为 aliyun.com,IP 地址段长度为 5,后缀为 test,则节点名称为 aliyun.com00055test。

aliyun.com192.XX.YY.55test

pre_user_data

string

节点池预自定义数据,即运行于节点初始化之前的脚本。更多详情,请参见生成实例自定义数据

IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD

tee_config

object

加密计算配置。

tee_enable

boolean

是否开启加密计算集群,取值:

  • true:开启。

  • false:不开启。

false

interconnect_config

object

【该字段已废弃】

边缘节点池网络相关的配置。该值只对 edge 类型的节点池有意义。

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

interconnect_mode

string

边缘节点池的网络类型,该参数仅对typeedge类型的节点池生效,取值范围:

  • basic:公网。节点池内的节点通过公网与云端节点进行交互,节点池内应用不能直接访问云端 VPC 内网。

  • private:专用网络。节点池内的节点通过专线、VPN 或 CEN 等方式实现云上与云下网络打通,拥有更高的云边通信质量,提供更有效的安全保障。

basic

auto_mode

object

智能托管配置。

enable

boolean

是否开启智能托管。

true

node_components

array<object>

节点组件列表。

array<object>

节点组件。

name

string

节点组件名称。

kubelet

version

string

节点组件版本。

1.33.3-aliyun.1

config

object

节点组件配置。

custom_config

object

节点组件自定义配置。

{"cpuManagerPolicy":"static"}

any

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

cpuManagerPolicy

config_revision

string

节点组件自定义配置版本号。

1

eflo_node_group

object

灵骏节点组信息。

cluster_id

string

灵骏集群 ID。

i113790071760688002461

group_id

string

灵骏分组 ID。

i128147721760688002463

auto_attach_enabled

boolean

是否开启灵骏节点池自动添加 (不生效)

worker_ram_role_name

string

灵骏节点池所使用的 Worker Ram Role

樣本

正常返回樣本

JSON格式

{
  "nodepools": [
    {
      "nodepool_info": {
        "nodepool_id": "np615c0e0966124216a0412e10afe0****",
        "name": "default-nodepool",
        "type": "ess",
        "is_default": true,
        "resource_group_id": "rg-acfmyvw3wjm****",
        "region_id": "cn-beijing",
        "created": "2025-04-15T16:33:29.362888807+08:00",
        "updated": "2025-04-15T16:33:32.823+08:00"
      },
      "status": {
        "state": "active",
        "healthy_nodes": 3,
        "initial_nodes": 0,
        "failed_nodes": 0,
        "offline_nodes": 0,
        "removing_nodes": 0,
        "serving_nodes": 3,
        "total_nodes": 3
      },
      "auto_scaling": {
        "enable": true,
        "type": "cpu",
        "max_instances": 10,
        "min_instances": 2,
        "eip_internet_charge_type": "PayByBandwidth",
        "is_bond_eip": true,
        "eip_bandwidth": 5
      },
      "management": {
        "enable": true,
        "auto_repair": true,
        "auto_repair_policy": {
          "restart_node": true,
          "approval_required": false,
          "auto_repair_policy_id": "r-xxxxxxxxx"
        },
        "auto_vul_fix": true,
        "auto_vul_fix_policy": {
          "restart_node": true,
          "vul_level": "asap,nntf",
          "exclude_packages": "kernel"
        },
        "auto_upgrade": true,
        "auto_upgrade_policy": {
          "auto_upgrade_kubelet": true
        },
        "upgrade_config": {
          "auto_upgrade": true,
          "surge": 5,
          "surge_percentage": 50,
          "max_unavailable": 1
        },
        "auto_fault_diagnosis": false,
        "drift_enabled": false
      },
      "scaling_group": {
        "scaling_group_id": "asg-2ze8n5qw4atggut8****",
        "vswitch_ids": [
          "vsw-2ze3ds0mdip0hdz8i****"
        ],
        "instance_types": [
          "ecs.n4.large"
        ],
        "instance_charge_type": "PostPaid",
        "period": 1,
        "period_unit": "Month",
        "auto_renew": false,
        "auto_renew_period": 0,
        "spot_strategy": "NoSpot",
        "spot_price_limit": [
          {
            "instance_type": "ecs.c6.large",
            "price_limit": "0.39"
          }
        ],
        "image_type": "AliyunLinux3",
        "image_id": "aliyun_3_x64_20G_alibase_20241218.vhd",
        "system_disk_category": "cloud_efficiency",
        "system_disk_categories": [
          "EESSD云盘"
        ],
        "system_disk_size": 120,
        "system_disk_performance_level": "PL1",
        "system_disk_encrypted": false,
        "system_disk_kms_key_id": "0e478b7a-4262-4802-b8cb-00d3fb40****",
        "system_disk_encrypt_algorithm": "aes-256",
        "system_disk_bursting_enabled": true,
        "system_disk_provisioned_iops": 1000,
        "data_disks": [
          {
            "category": "cloud_ssd",
            "size": 40,
            "encrypted": "true",
            "kms_key_id": "0e478b7a-4262-4802-b8cb-00d3fb40****",
            "auto_snapshot_policy_id": "sp-2zej1nogjvovnz4z****",
            "performance_level": "PL1",
            "provisioned_iops": 1000,
            "bursting_enabled": true,
            "auto_format": true,
            "file_system": "ext4",
            "mount_target": "/mnt/path1",
            "disk_name": "DataDiskName",
            "device": "/dev/xvdb",
            "snapshot_id": "s-280s7****"
          }
        ],
        "disk_init": [
          {
            "disk_name": "disk0",
            "mkfs_type": "ext4",
            "mount_target": "/mnt/disk0",
            "mount_for_runtime": false,
            "local_disk": false
          }
        ],
        "security_group_ids": [
          "sg-2ze1iuk12m2sb4c4****"
        ],
        "key_pair": "pro-nodepool",
        "login_password": "******",
        "login_as_non_root": true,
        "cis_enabled": false,
        "soc_enabled": false,
        "security_hardening_os": false,
        "internet_charge_type": "PayByBandwidth",
        "internet_max_bandwidth_out": 10,
        "tags": [
          {
            "key": "env",
            "value": "prod"
          }
        ],
        "desired_size": 2,
        "multi_az_policy": "COST_OPTIMIZED",
        "scaling_policy": "release",
        "on_demand_base_capacity": 0,
        "on_demand_percentage_above_base_capacity": 20,
        "spot_instance_pools": 5,
        "spot_instance_remedy": false,
        "compensate_with_on_demand": true,
        "deploymentset_id": "ds-bp1d19mmbsv3jf6xxxxx",
        "rds_instances": [
          "rm-xxx"
        ],
        "private_pool_options": {
          "id": "eap-bp67acfmxazb4****",
          "match_criteria": "Open"
        },
        "security_group_id": "sg-2ze1iuk12m2sb4c4****",
        "platform": "AliyunLinux",
        "ram_policy": "KubernetesWorkerRole-021dc54f-929b-437a-8ae0-34c24d3e****",
        "instance_patterns": [
          {
            "cores": 4,
            "memory": 8,
            "instance_family_level": "EnterpriseLevel",
            "excluded_instance_types": [
              "ecs.c6.large"
            ],
            "min_cpu_cores": 4,
            "max_cpu_cores": 8,
            "min_memory_size": 8,
            "max_memory_size": 16,
            "instance_categories": [
              "General-purpose"
            ],
            "cpu_architectures": [
              "X86"
            ],
            "core": 4,
            "max_price": 2,
            "architectures": [
              "X86"
            ],
            "burst_performance_option": "Exclude",
            "instance_type_families": [
              "ecs.c6"
            ],
            "minimum_eni_quantity": 3,
            "minimum_eni_private_ip_address_quantity": 10,
            "minimum_eni_ipv6_address_quantity": 1,
            "maximum_gpu_amount": 8
          }
        ],
        "ram_role_name": "KubernetesWorkerRole-4a4fa089-80c1-48a5-b3c6-9349311f****",
        "resource_pool_options": {
          "strategy": "PrivatePoolFirst",
          "private_pool_ids": [
            "eap-bp1c1fohub5jccwi****"
          ]
        },
        "system_disk_snapshot_policy_id": "sp-0jl6xnmme8v7o935****"
      },
      "node_config": {
        "kubelet_configuration": {
          "registryPullQPS": 5,
          "registryBurst": 10,
          "eventRecordQPS": 5,
          "eventBurst": 10,
          "kubeAPIQPS": 5,
          "kubeAPIBurst": 10,
          "serializeImagePulls": true,
          "cpuManagerPolicy": "none",
          "evictionHard": {
            "test": "test",
            "test2": 1
          },
          "evictionSoft": {
            "test": "test",
            "test2": 1
          },
          "evictionSoftGracePeriod": {
            "test": "test",
            "test2": 1
          },
          "systemReserved": {
            "test": "test",
            "test2": 1
          },
          "kubeReserved": {
            "test": "test",
            "test2": 1
          },
          "readOnlyPort": 0,
          "maxPods": 110,
          "containerLogMaxSize": "10Mi",
          "containerLogMaxFiles": 5,
          "featureGates": {
            "test": "test",
            "test2": 1
          },
          "allowedUnsafeSysctls": [
            "net.core.somaxconn"
          ],
          "reservedMemory": [
            {
              "numaNode": 0,
              "limits": {
                "memory": "1Gi"
              }
            }
          ],
          "memoryManagerPolicy": "none",
          "cpuCFSQuota": true,
          "cpuCFSQuotaPeriod": "100ms",
          "imageGCHighThresholdPercent": 85,
          "imageGCLowThresholdPercent": 80,
          "podPidsLimit": -1,
          "topologyManagerPolicy": "restricted",
          "clusterDNS": [
            "127.0.xx.xx"
          ],
          "tracing": {
            "endpoint": "localhost:4317",
            "samplingRatePerMillion": 200000
          },
          "containerLogMaxWorkers": 1,
          "containerLogMonitorInterval": "10s",
          "serverTLSBootstrap": true
        },
        "node_os_config": {
          "hugepage": {
            "transparentEnabled": "",
            "transparentDefrag": "",
            "khugepagedDefrag": 0,
            "khugepagedAllocSleepMillisecs": 0,
            "khugepagedScanSleepMillisecs": 0,
            "khugepagedPagesToScan": 0
          }
        }
      },
      "kubernetes_config": {
        "labels": [
          {
            "key": "env",
            "value": "prod"
          }
        ],
        "taints": [
          {
            "key": "key",
            "value": "value",
            "effect": "NoSchedule"
          }
        ],
        "runtime": "containerd",
        "runtime_version": "1.6.38",
        "cpu_policy": "none",
        "user_data": "IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD****",
        "unschedulable": true,
        "cms_enabled": true,
        "node_name_mode": "aliyun.com192.XX.YY.55test",
        "pre_user_data": "IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD"
      },
      "tee_config": {
        "tee_enable": false
      },
      "interconnect_config": {
        "cen_id": "cen-ey9k9nfhz0f*******",
        "ccn_id": "ccn-qm5i0i0q9yi*******",
        "ccn_region_id": "cn-shanghai",
        "bandwidth": 10,
        "improved_period": "1"
      },
      "max_nodes": 10,
      "interconnect_mode": "basic",
      "auto_mode": {
        "enable": true
      },
      "node_components": [
        {
          "name": "kubelet",
          "version": "1.33.3-aliyun.1",
          "config": {
            "custom_config": {
              "key": "cpuManagerPolicy"
            }
          },
          "config_revision": "1"
        }
      ],
      "eflo_node_group": {
        "cluster_id": "i113790071760688002461",
        "group_id": "i128147721760688002463",
        "auto_attach_enabled": false,
        "worker_ram_role_name": ""
      }
    }
  ]
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情