您可以根据节点池ID,调用DescribeClusterNodePoolDetail接口查询集群中目标节点池的配置。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
cs:DescribeClusterNodePoolDetail |
get |
*Cluster
|
无 | 无 |
请求语法
GET /clusters/{ClusterId}/nodepools/{NodepoolId} HTTP/1.1
路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ClusterId |
string |
是 |
集群 ID。 |
c23421cfa74454bc8b37163fd19af**** |
| NodepoolId |
string |
是 |
节点池 ID。 |
np31da1b38983f4511b490fc62108a**** |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
当前API无需请求参数
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
节点池详情。 |
||
| nodepool_info |
object |
节点池配置。 |
|
| nodepool_id |
string |
节点池 ID。 |
np615c0e0966124216a0412e10afe0**** |
| name |
string |
节点池名称。 |
default-nodepool |
| type |
string |
节点池类型。
|
ess |
| is_default |
boolean |
是否为默认节点池,通常一个集群仅有一个默认节点池。取值:
|
true |
| resource_group_id |
string |
资源组 ID。 |
rg-acfmyvw3wjmb**** |
| region_id |
string |
地域 ID。 |
cn-beijing |
| created |
string |
节点池创建时间。 |
2025-04-10T14:25:37.285530433+08:00 |
| updated |
string |
节点池更新时间。 |
2025-04-15T15:39:45.41+08:00 |
| status |
object |
节点池状态。 |
|
| state |
string |
节点池状态,取值:
|
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 |
| conditions |
array<object> |
节点池现状,表示节点池不同维度的状态信息。 |
|
|
object |
单个状态属性。 |
||
| type |
string |
类型。 |
ImageUpgradeReady |
| status |
string |
状态。 |
True |
| reason |
string |
原因。 |
UpgradeDisabled |
| message |
string |
详细信息。 |
AutoUpgradeDisabled |
| last_transition_time |
string |
上一次状态转换时间。 |
20**-**-30T10:39:00+08:00 |
| auto_scaling |
object |
自动伸缩节点池配置。 |
|
| enable |
boolean |
是否启用自动伸缩,取值:
当取值为 false 时, |
true |
| type |
string |
自动伸缩类型,按照自动伸缩实例类型划分。取值:
|
cpu |
| max_instances |
integer |
节点池中可伸缩的最大实例数,不包含您已有的实例。 |
10 |
| min_instances |
integer |
节点池中可伸缩的最小实例数,不包含您已有的实例。 |
1 |
| eip_internet_charge_type |
string |
EIP 计费类型,取值:
|
PayByBandwidth |
| is_bond_eip |
boolean |
是否绑定 EIP,取值:
|
true |
| eip_bandwidth |
integer |
EIP 带宽峰值。 取值范围:[1,100],单位:Mbps。 |
5 |
| management |
object |
托管节点池配置。 |
|
| enable |
boolean |
是否开启托管版节点池,取值:
|
true |
| auto_repair |
boolean |
自动修复,仅当
|
true |
| auto_repair_policy |
object |
自动修复节点策略。 |
|
| restart_node |
boolean |
是否允许重启节点。仅当
|
true |
| approval_required |
boolean |
节点修复是否需要人工审批。 |
false |
| auto_repair_policy_id |
string |
自动修复策略 ID |
r-xxxxxxxxxx |
| auto_vul_fix |
boolean |
是否自动修复 CVE。仅当
|
true |
| auto_vul_fix_policy |
object |
自动修复 CVE 策略。 |
|
| restart_node |
boolean |
是否允许重启节点,仅当
|
true |
| vul_level |
string |
允许自动修复的漏洞级别,以逗号分隔。
|
asap,nntf |
| exclude_packages |
string |
在漏洞修复过程中应排除的包。 |
kernel |
| auto_upgrade |
boolean |
是否自动升级节点,仅当
|
true |
| auto_upgrade_policy |
object |
自动升级策略。 |
|
| auto_upgrade_kubelet |
boolean |
是否允许自动升级 kubelet,仅当
|
true |
| upgrade_config |
object |
自动升级配置,仅当 |
|
| auto_upgrade |
boolean |
是否启用自动升级,取值:
|
true |
| surge |
integer |
额外节点数量。和 surge_percentage 二选一。 |
5 |
| surge_percentage |
integer |
额外节点数的百分比,和 额外节点数=额外节点数比例×节点数,例如,设置额外节点数比例为 50%,存在的节点数为 6,那么将产生的额外节点数=50%×6,也就是将产生 3 个额外节点数。 |
50 |
| max_unavailable |
integer |
最大不可用节点数量,取值范围:[1,1000]。 默认值:1。 |
1 |
| scaling_group |
object |
节点池伸缩组配置。 |
|
| scaling_group_id |
string |
伸缩组 ID。 |
asg-2zeieod8giqmov7z**** |
| vswitch_ids |
array |
虚拟交换机 ID 列表。 |
|
|
string |
虚拟交换机 ID。 |
vsw-2ze3ds0mdip0hdz8i**** |
|
| instance_types |
array |
节点实例规格列表。 |
|
|
string |
节点实例规格。 |
ecs.n4.large |
|
| instance_charge_type |
string |
节点池节点付费类型,取值:
|
PostPaid |
| period |
integer |
节点包年包月时长,当
|
0 |
| period_unit |
string |
节点付费周期,当
|
Month |
| auto_renew |
boolean |
节点是否开启自动续费,当
|
false |
| auto_renew_period |
integer |
单次自动续费的续费时长。取值范围:
|
1 |
| spot_strategy |
string |
抢占式实例类型,取值:
更多信息,请参见抢占式实例。 |
NoSpot |
| spot_price_limit |
array<object> |
抢占实例市场价格区间配置。 |
|
|
object |
抢占实例市场价格区间配置,可为不同实例规格设置不同的价格区间。 |
||
| instance_type |
string |
抢占式实例规格。 |
ecs.c6.large |
| price_limit |
string |
单台实例市场价格。 单位:元/时。 |
0.39 |
| image_type |
string |
操作系统镜像类型。
|
AliyunLinux3 |
| image_id |
string |
自定义镜像 ID。 |
aliyun_3_x64_20G_alibase_20241218.vhd |
| system_disk_category |
string |
节点系统盘类型,取值:
|
cloud_efficiency |
| system_disk_categories |
array |
系统盘的多磁盘类型。当无法使用高优先级的磁盘类型时,自动尝试下一优先级的磁盘类型创建系统盘。 |
|
|
string |
节点系统盘类型。 取值:
|
cloud_essd |
|
| system_disk_size |
integer |
节点系统盘大小,单位为 GiB。 取值范围:[20,2048]。 |
120 |
| system_disk_performance_level |
string |
节点系统盘磁盘性能,只对 ESSD 磁盘生效。磁盘性能等级和磁盘大小有关。更多信息,请参见 ESSD 云盘。
|
PL1 |
| system_disk_encrypted |
boolean |
是否加密系统盘。取值:
|
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 |
| system_disk_provisioned_iops |
integer |
节点系统盘预配置的读写 IOPS。 可能值:0~min{50,000, 1000*容量-基准性能}。 基准性能=min{1,800+50*容量, 50000}。 当 |
1000 |
| data_disks |
array |
节点数据盘类型、大小等配置的组合。 |
|
| data_disk |
节点数据盘配置。 |
||
| disk_init |
array |
块设备初始化配置。 |
|
|
DiskInit |
DiskInit 配置。 |
||
| security_group_ids |
array |
节点池安全组 ID 列表。 |
|
|
string |
节点池安全组 ID。 |
sg-2ze60ockeekspl3d**** |
|
| key_pair |
string |
密钥对名称,和 |
pro-nodepool |
| login_password |
string |
SSH 登录密码,和 出于安全性考虑,密码查询结果经过加密处理。 |
******** |
| login_as_non_root |
boolean |
弹出的 ECS 实例是否使用以非 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 安全加固。取值:
默认值: |
false |
| internet_charge_type |
string |
节点公网 IP 网络计费类型。
|
PayByBandwidth |
| internet_max_bandwidth_out |
integer |
节点公网 IP 出带宽最大值,单位为 Mbps(Mega bit per second),取值范围:1~100。 |
10 |
| tags |
array |
ECS 实例标签。 |
|
| tag |
节点标签。 |
||
| desired_size |
integer |
节点池期望节点数。 |
2 |
| multi_az_policy |
string |
多可用区伸缩组 ECS 实例扩缩容策略。取值:
默认值: |
BALANCE |
| scaling_policy |
string |
伸缩组模式,取值:
|
release |
| on_demand_base_capacity |
integer |
伸缩组所需要按量实例个数的最小值,取值范围:[0,1000]。当按量实例个数少于该值时,将优先创建按量实例。 |
0 |
| on_demand_percentage_above_base_capacity |
integer |
伸缩组满足最小按量实例数( |
20 |
| spot_instance_pools |
integer |
指定可用实例规格的个数,伸缩组将按成本最低的多个规格均衡创建抢占式实例。取值范围:[1,10]。 |
5 |
| spot_instance_remedy |
boolean |
是否开启补齐抢占式实例。开启后,当收到抢占式实例将被回收的系统消息时,伸缩组将尝试创建新的实例,替换掉将被回收的抢占式实例。取值:
|
false |
| compensate_with_on_demand |
boolean |
当
|
true |
| deploymentset_id |
string |
部署集 ID。 |
ds-bp1d19mmbsv3jf6xxxxx |
| rds_instances |
array |
如果指定了 RDS 实例列表,集群节点 ECS 会自动加入 RDS 访问白名单。 |
|
|
string |
RDS 实例。 |
rm-xxx |
|
| private_pool_options |
object |
私有节点池配置。 |
|
| id |
string |
私有节点池 ID。 |
eap-bp67acfmxazb4**** |
| match_criteria |
string |
私有节点池类型,实例启动的私有池容量选项。弹性保障服务或容量预定服务在生效后会生成私有池容量,供实例启动时选择。取值:
|
Open |
| security_group_id |
string |
节点池安全组 ID,当节点池绑定了多个安全组时,为 |
sg-2ze60ockeekspl3d**** |
| platform |
string |
操作系统发行版。取值:
|
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**** |
| instance_metadata_options | InstanceMetadataOptions |
ECS 实例的元数据访问配置。 |
|
| resource_pool_options |
object |
创建实例时使用的资源池及资源池策略。 |
|
| private_pool_ids |
array |
私有池 ID 列表。 |
|
|
string |
私有池 ID。 |
eap-bp1c1fohub5jccwi**** |
|
| strategy |
string |
创建实例时使用的资源池策略。取值范围: PrivatePoolFirst:私有池优先。 PrivatePoolOnly:仅限私有池。 None:不使用资源池策略。 |
PrivatePoolFirst |
| system_disk_snapshot_policy_id |
string |
系统盘快照策略 |
sp-bp11g8z59rawcud9**** |
| node_config |
object |
节点配置。 |
|
| kubelet_configuration | kubelet_config |
Kubelet 参数配置。 |
|
| node_os_config |
object |
节点操作系统配置。 |
|
| hugepage |
Hugepage |
Hugepage 配置。 |
|
| kubernetes_config |
object |
集群相关配置。 |
|
| labels |
array |
节点标签。 |
|
| tag |
ECS 标签。 |
||
| taints |
array |
节点污点信息。污点和容忍度(Toleration)相互配合,可以用来避免 Pod 被分配到不合适的节点上。更多信息,请参见taint-and-toleration。 |
|
| taint |
节点污点配置。 |
||
| runtime |
string |
容器运行时名称,ACK 支持以下三种容器运行时。
|
containerd |
| runtime_version |
string |
容器运行时版本。 |
1.6.38 |
| cpu_policy |
string |
节点 CPU 管理策略。当集群版本在 1.12.6 及以上时支持以下两种策略:
|
none |
| user_data |
string |
节点池自定义数据,即运行于节点初始化之后的脚本。更多详情,请参见生成实例自定义数据。 |
IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFDSyEi |
| unschedulable |
boolean |
扩容后的节点是否不可调度。
|
true |
| cms_enabled |
boolean |
是否在 ECS 节点上安装云监控,安装后可以在云监控控制台查看所创建 ECS 实例的监控信息,推荐开启。取值:
|
true |
| node_name_mode |
string |
自定义节点名称。 节点名称由三部分组成:前缀 + 节点 IP 地址子串 + 后缀:
例如,节点 IP 地址为:192.168.0.55,指定前缀为 aliyun.com,IP 地址段长度为 5,后缀为 test,则节点名称为 aliyun.com00055test。 |
aliyun.com192.XX.YY.55test |
| pre_user_data |
string |
节点池预自定义数据,即运行于节点初始化之前的脚本。更多详情,请参见生成实例自定义数据。 |
dGhpcyBpcyBhIGV4YW1wbGU |
| tee_config |
object |
加密计算节集群配置。 |
|
| tee_enable |
boolean |
是否开启加密计算集群,取值:
|
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 |
【该字段已废弃】 边缘节点池允许容纳的最大节点数量。 |
10 |
| interconnect_mode |
string |
边缘节点池的网络类型,该参数仅对
|
basic |
| host_network |
boolean |
Pod 网络模式是否采用主机网络模式。
|
true |
| intranet |
boolean |
边缘节点池内,节点之间是否三层网络互通。
|
true |
| auto_mode |
object |
智能托管配置。 |
|
| enable |
boolean |
是否开启 |
false |
| node_components |
array<object> |
节点组件列表。 |
|
|
array<object> |
节点组件。 |
||
| name |
string |
节点组件名称。 |
kubelet |
| version |
string |
节点组件版本。 |
1.33.3-aliyun.1 |
| config |
object |
节点组件配置。 |
|
| custom_config |
object |
节点组件自定义配置。 |
|
|
string |
节点组件自定义配置字符串。 |
cpuManagerPolicy |
|
| eflo_node_group |
object |
||
| cluster_id |
string |
i113790071760688002461 |
|
| group_id |
string |
i128147721760688002463 |
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。