文档首页/ 云容器引擎 CCE/ API参考/ API/ 节点管理/ 查询集群中超节点列表 - ListHyperNodes
更新时间：2025-12-19 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询集群中超节点列表 - ListHyperNodes

功能介绍

该API用于获取指定集群下所有超节点的详细信息。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    cce:hypernode:list

    List

    cluster *

    -

    -

    -

URI

GET /api/v3/projects/{project_id}/clusters/{cluster_id}/hypernodes

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目ID，获取方式请参见如何获取接口URI中参数。

约束限制：

不涉及

取值范围：

账号的项目ID

默认取值：

不涉及

cluster_id

是

String

参数解释：

集群ID，获取方式请参见如何获取接口URI中参数。

约束限制：

不涉及

取值范围：

集群ID

默认取值：

不涉及
表2 Query参数

参数

是否必选

参数类型

描述

limit

否

Integer

参数解释：

设置每页显示的数据条数

约束限制：

不涉及

取值范围：

1到1000之间（含1和1000）的整数

默认取值：

100

offset

否

Integer

参数解释：

设置从第几条数据开始显示（用于翻页），比如输入0表示从第一条数据开始，输入10表示跳过前10条，从第11条开始显示，不填时默认从第一条开始显示（即默认为0）。

约束限制：

不涉及

取值范围：

32 位非负整数

默认取值：

0

请求参数

无

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

hyperNodeList

Array of HyperNode objects

超节点
表4 HyperNode

参数

参数类型

描述

apiVersion

String

v3

kind

String

HyperNode

metadata

HyperNodeMetadata object

超节点元数据

spec

HyperNodeSpec object

超节点信息

status

HyperNodeStatus object

超节点状态
表5 HyperNodeMetadata

参数

参数类型

描述

name

String

参数解释：

超节点名称

说明：
命名规则：以小写字母开头，由小写字母、数字、中划线(-)组成，长度范围1-56位，且不能以中划线(-)结尾。

uid

String

参数解释：

超节点ID，资源唯一标识，创建成功后自动生成，填写无效

creationTimestamp

String

参数解释：

创建时间，创建成功后自动生成，填写无效

updateTimestamp

String

参数解释：

更新时间，自动生成，填写无效

ownerReference

ownerReference object

属主对象
表6 ownerReference

参数

参数类型

描述

nodepoolName

String

参数解释：

节点池名称

nodepoolID

String

参数解释：

节点池ID
表7 HyperNodeSpec

参数

参数类型

描述

flavor

String

参数解释：

超节点规格

nodepoolID

String

参数解释：

所属节点池ID

nodeTemplate

Array of NodeTemplateInHyperNode objects

参数解释：

超节点下节点相关的配置。

chargeMode

String

参数解释：

付费方式

取值范围：

  • prepaid: 预付费，即包年包月；

  • postpaid: 后付费，即按需付费；
表8 NodeTemplateInHyperNode

参数

参数类型

描述

az

String

参数解释：

超节点下节点所在的可用区。

CCE支持的可用区请参考地区和终端节点。

os

String

参数解释：

超节点下节点的操作系统类型。具体支持的操作系统请参见节点操作系统说明。

login

Login object

参数解释：

节点的登录方式。

rootVolume

Volume object

参数解释：

节点的系统卷信息。

dataVolumes

Array of Volume objects

参数解释：

节点的数据盘参数。

storage

Storage object

参数解释：

磁盘初始化配置管理参数。

该参数配置逻辑较为复杂，详细说明请参见节点磁盘挂载。

约束限制：

  • v1.15.11-r0及以上集群版本支持此字段。不支持集群版本填写此字段将被忽略。

  • 如存在节点规格涉及本地盘并同时使用云硬盘场景时，请勿缺省此参数，避免出现将用户未期望的磁盘分区。

  • 如希望数据盘取值范围调整至20-32768，请勿缺省此参数。

  • 如希望使用共享磁盘空间(取消runtime和kubernetes分区)，请勿缺省此参数，共享磁盘空间请参考数据盘空间分配说明。

  • 如希望系统组件存储在系统盘中，请勿缺省此参数。

k8sTags

Map<String,String>

参数解释：

超节点创建时下发到节点上的 k8s 标签，格式为key/value键值对。

示例：

"k8sTags": {
  "key": "value"
}

runtime

Runtime object

参数解释：

容器运行时

extendParam

NodeExtendParam object

参数解释：

创建节点时的扩展参数。

hostnameConfig

HostnameConfig object

参数解释：

K8S节点名称配置参数。
表9 Login

参数

参数类型

描述

sshKey

String

参数解释：

选择密钥对方式登录时的密钥对名称。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

userPassword

UserPassword object

参数解释：

选择密码方式登录时的账号密码信息，之后可通过此账号密码登录节点。

约束限制：

不涉及

removeUserPassword

Boolean

参数解释：

更新节点池时，移除当前节点池密码方式登录的配置

约束限制：

仅更新节点池场景支持该参数，设置为true时不允许设置userPassword

取值范围：

不涉及

默认取值：

false

removeSSHKey

Boolean

参数解释：

更新节点池时，移除当前节点池密钥对方式登录的配置

约束限制：

仅更新节点池场景支持该参数，设置为true时不允许设置sshKey

取值范围：

不涉及

默认取值：

false
表10 UserPassword

参数

参数类型

描述

username

String

参数解释：

登录账号，默认为“root”。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

root。

password

String

参数解释：

登录密码，若创建节点通过用户名密码方式，即使用该字段，则响应体中该字段作屏蔽展示。

约束限制：

创建节点时password字段需要加盐加密，具体方法请参见创建节点时password字段加盐加密。

取值范围：

密码复杂度要求：

  • 长度为8-26位。

  • 密码至少必须包含大写字母、小写字母、数字和特殊字符（!@$%^-_=+[{}]:,./?）中的三种。

  • 密码不能包含用户名或用户名的逆序。

默认取值：

不涉及
表11 Volume

参数

参数类型

描述

size

Integer

参数解释：

磁盘大小，单位为GiB。

约束限制：

不涉及

取值范围：

  • 系统盘取值范围：40~1024

  • 第一块数据盘取值范围：20~32768(当缺省磁盘初始化配置管理参数storage时，数据盘取值范围：100-32768)

  • 其他数据盘取值范围：10~32768(当缺省磁盘初始化配置管理参数storage时，数据盘取值范围：100-32768)

默认取值：

不涉及

volumetype

String

参数解释：

磁盘类型，取值请参见创建云服务器 中“root_volume字段数据结构说明”。

约束限制：

不涉及

取值范围：

  • SAS：高IO，是指由SAS存储提供资源的磁盘类型。

  • SSD：超高IO，是指由SSD存储提供资源的磁盘类型。

  • SATA：普通IO，是指由SATA存储提供资源的磁盘类型。EVS已下线SATA磁盘，仅存量节点有此类型的磁盘。

  • ESSD：极速型SSD云硬盘，是指由极速型SSD存储提供资源的磁盘类型。

  • GPSSD：通用型SSD云硬盘，是指由通用型SSD存储提供资源的磁盘类型。

  • ESSD2：极速型SSD V2云硬盘，是指由极速型SSD V2存储提供资源的磁盘类型。

  • GPSSD2：通用型SSD V2云硬盘，是指由通用型SSD V2存储提供资源的磁盘类型。

说明：
了解不同磁盘类型的详细信息，链接请参见磁盘类型及性能介绍。

默认取值：

不涉及

iops

Integer

参数解释：

给云硬盘配置iops。

约束限制：

  • 购买GPSSD2、ESSD2类型的云硬盘时必填，其他类型不能设置。

  • 只支持按需计费。

取值范围：

了解GPSSD2、ESSD2类型的iops大小范围，请参见云硬盘类型及性能介绍里面的云硬盘性能数据表。

默认取值：

不涉及

throughput

Integer

参数解释：

给云硬盘配置吞吐量，单位是MiB/s。

约束限制：

  • 购买GPSSD2类型云硬盘时必填，其他类型不能设置。

  • 只支持按需计费。

取值范围：

了解GPSSD2类型的吞吐量大小范围，请参见云硬盘类型及性能介绍里面的云硬盘性能数据表。

默认取值：

不涉及

extendParam

Map<String,Object>

参数解释：

磁盘扩展参数，取值请参见创建云服务器中“extendparam”参数的描述。

链接请参见创建磁盘的extendparam字段数据结构说明。

约束限制：

不涉及

cluster_id

String

参数解释：

云服务器系统盘对应的存储池的ID。仅用作专属云集群，专属分布式存储DSS的存储池ID，即dssPoolID。

获取方法请参见获取单个专属分布式存储池详情中“表3 响应参数”的ID字段。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

cluster_type

String

参数解释：

云服务器系统盘对应的磁盘存储类型。

约束限制：

不涉及

取值范围：

仅用作专属云集群，固定取值为dss。

默认取值：

不涉及

hw:passthrough

Boolean

参数解释：

  • 使用SDI规格创建虚拟机时请关注该参数，如果该参数值为true，说明创建的为SCSI类型的卷；

  • 节点池类型为ElasticBMS时，此参数必须填写为true；

  • 如存在节点规格涉及本地盘并同时使用云硬盘场景时，请设置磁盘初始化配置管理参数，配置参考：节点磁盘挂载。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

metadata

VolumeMetadata object

参数解释：

云硬盘加密信息，仅在创建节点系统盘或数据盘需加密时须填写。

约束限制：

不涉及
表12 VolumeMetadata

参数

参数类型

描述

__system__encrypted

String

参数解释：

表示云硬盘加密功能的字段，'0'代表不加密，'1'代表加密。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

该字段不存在时，云硬盘默认为不加密。

__system__cmkid

String

参数解释：

用户主密钥ID，是metadata中的表示加密功能的字段，与__system__encrypted配合使用。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及
表13 Storage

参数

参数类型

描述

storageSelectors

Array of StorageSelectors objects

参数解释：

磁盘选择，根据matchLabels和storageType对匹配的磁盘进行管理。磁盘匹配存在先后顺序，靠前的匹配规则优先匹配。

约束限制：

不涉及

storageGroups

Array of StorageGroups objects

参数解释：

由多个存储设备组成的存储组，用于各个存储空间的划分。

约束限制：

不涉及
表14 StorageSelectors

参数

参数类型

描述

name

String

参数解释：

selector的名字，作为storageGroup中selectorNames的索引。

约束限制：

各个selector间的名字不能重复。

取值范围：

不涉及

默认取值：

不涉及

storageType

String

参数解释：

存储类型。

约束限制：

  • local存储类型不支持磁盘选择，所有本地盘将被组成一个VG，因此也仅允许只有一个local类型的storageSelector。

  • system存储类型不支持磁盘选择，选择系统盘作为系统组件存储磁盘。因此也仅允许只有一个system类型的storageSelector，且name必须为cceUse。

取值范围：

当前仅支持evs（云硬盘）、local（本地盘）和system（系统盘）。

默认取值：

不涉及

matchLabels

matchLabels object

参数解释：

evs盘的匹配字段。

约束限制：

storageType设置为system（系统盘）时，无需设置此字段。

取值范围：

支持DataVolume中的size、volumeType、iops、throughput、metadataEncrypted、metadataCmkid、count字段。

默认取值：

不涉及
表15 matchLabels

参数

参数类型

描述

size

String

参数解释：

匹配的磁盘大小，不填则无磁盘大小限制。例如：100。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

volumeType

String

参数解释：

云硬盘类型，目前支持SSD、GPSSD、SAS、ESSD、SATA等，不填则无云硬盘类型限制。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

iops

String

参数解释：

匹配的磁盘iops大小，不填则无磁盘iops大小限制。当需要选择GPSSD2或ESSD2类型磁盘时，配置iops来准确选择磁盘。例如：3000。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

throughput

String

参数解释：

匹配的磁盘吞吐量大小，不填则无磁盘吞吐量大小限制。当需要选择GPSSD2类型磁盘时，配置throughput来准确选择磁盘。例如：125。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

metadataEncrypted

String

参数解释：

磁盘加密标识符，0代表不加密，1代表加密，不填则无磁盘加密标识符限制。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

metadataCmkid

String

参数解释：

加密磁盘的用户主密钥ID，长度为36字节的字符串，不填则无磁盘密钥ID限制。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

count

String

参数解释：

磁盘选择个数，不填则选择所有此类磁盘。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及
表16 StorageGroups

参数

参数类型

描述

name

String

参数解释：

storageGroups的名字，作为虚拟存储组的名字，因此各个group名字不能重复。

约束限制：

不涉及

取值范围：

  • 当cceManaged=true时，name必须为：vgpaas。

  • 当数据盘作为临时存储卷时：name必须为：vg-everest-localvolume-ephemeral。

  • 当数据盘作为持久存储卷时：name必须为：vg-everest-localvolume-persistent。

默认取值：

不涉及

cceManaged

Boolean

参数解释：

k8s及runtime所属存储空间。有且仅有一个group被设置为true，不填默认false。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

selectorNames

Array of strings

参数解释：

对应storageSelectors中的name，一个group可选择多个selector；但一个selector只能被一个group选择。

约束限制：

系统组件无法分别存储于系统盘与数据盘中，因此选择selector的type为system时，group只能选择一个selector。

virtualSpaces

Array of VirtualSpace objects

参数解释：

group中空间配置的详细管理。

约束限制：

不涉及
表17 VirtualSpace

参数

参数类型

描述

name

String

参数解释：

virtualSpace的名称，当前仅支持四种类型：share、kubernetes、runtime、user。

约束限制：

不涉及

取值范围：

  • kubernetes：k8s空间配置，需配置lvmConfig；

  • runtime：运行时空间配置，需配置runtimeConfig；

  • user：用户空间配置，需配置lvmConfig。

默认取值：

不涉及

size

String

参数解释：

virtualSpace的大小，仅支持整数百分比。例如：90%。

约束限制：

不涉及

取值范围：

该参数取值范围[10-90]，一个group中所有virtualSpace的百分比之和不得超过100%

默认取值：

不涉及

lvmConfig

LVMConfig object

参数解释：

lvm配置管理，适用于share、kubernetes和user空间配置。

约束限制：

一个virtualSpace仅支持一个config配置。

runtimeConfig

RuntimeConfig object

参数解释：

runtime配置管理，适用于运行时空间配置。

约束限制：

一个virtualSpace仅支持一个config配置。
表18 LVMConfig

参数

参数类型

描述

lvType

String

参数解释：

LVM写入模式：linear、striped。linear：线性模式；striped：条带模式，使用多块磁盘组成条带模式，能够提升磁盘性能。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

path

String

参数解释：

磁盘挂载路径，仅在用户配置中生效，支持包含：数字、大小写字母、点、中划线、下划线的绝对路径。

约束限制：

挂载路径请填写业务目录路径，不可设置为空或根目录等操作系统关键路径。不可填写的操作系统关键路径如下：

/, /home, /home/, /bin, /bin/, /lib, /lib/, /root, /root/, /boot, /boot/, /dev, /dev/, /etc, /etc/, /lost+found, /lost+found/, /mnt, /mnt/, /proc, /proc/,/sbin, /sbin/, /srv, /srv/, /tmp, /tmp/, /var, /var/, /media, /media/, /opt, /opt/, /selinux, /selinux/, /sys, /sys/, /usr, /usr/, /opt/cloud/, /mnt/paas/, /home/paas/, /var/paas/, /var/lib/, /var/script/

取值范围：

不涉及

默认取值：

不涉及
表19 RuntimeConfig

参数

参数类型

描述

lvType

String

参数解释：

LVM写入模式：linear、striped。linear：线性模式；striped：条带模式，使用多块磁盘组成条带模式，能够提升磁盘性能。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及
表20 Runtime

参数

参数类型

描述

name

String

参数解释：

容器运行时。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

  • v1.25以下集群：默认为"docker"；

  • v1.25及以上集群，随操作系统变化，默认的容器运行时不同；

  • 操作系统为EulerOS 2.5、EulerOS 2.8的节点默认为"docker"，其余操作系统的节点默认为"containerd"。
表21 NodeExtendParam

参数

参数类型

描述

ecs:performancetype

String

参数解释：

云服务器规格的分类。响应中会返回此字段。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

orderID

String

参数解释：

订单ID。

约束限制：

节点付费类型为自动付费包周期类型时，响应中会返回此字段(仅创建场景涉及)，节点池场景响应返回中无该参数。

取值范围：

不涉及

默认取值：

不涉及

productID

String

参数解释：

产品ID。

约束限制：

节点付费类型为自动付费包周期类型或者节点池类型是包周期节点池时，响应中会返回此字段。

取值范围：

不涉及

默认取值：

不涉及

maxPods

Integer

参数解释：

节点最大允许创建的实例数(Pod)，该数量包含系统默认实例。

该设置的目的为防止节点因管理过多实例而负载过重，请根据您的业务需要进行设置。

节点可以创建多少个Pod，受多个参数影响，具体请参见节点可创建的最大Pod数量说明。

约束限制：

不涉及

取值范围：

取值范围为16~256。

默认取值：

不涉及

periodType

String

参数解释：

订购周期类型。

约束限制：

  • 作为请求参数，billingMode为1（包周期）或2（已废弃：自动付费包周期）时生效，且为必选。

  • 作为响应参数，仅在创建包周期节点时返回。

取值范围：

  • month：月

  • year：年

默认取值：

不涉及

periodNum

Integer

参数解释：

订购周期数。

约束限制：

  • 作为请求参数，billingMode为1（包周期）或2（已废弃：自动付费包周期）时生效，且为必选。

  • 作为响应参数，仅在创建包周期节点时返回。

取值范围：

  • periodType=month（周期类型为月）时，取值为[1-9]。

  • periodType=year（周期类型为年）时，取值为[1-3]。

默认取值：

不涉及

isAutoRenew

String

参数解释：

是否自动续订。

约束限制：

billingMode为1或2（已废弃）时生效，不填写此参数时默认不会自动续费。

取值范围：

  • “true”：自动续订

  • “false”：不自动续订

默认取值：

不涉及

isAutoPay

String

参数解释：

下单订购后，是否自动从客户的账户中支付，而不需要客户手动去进行支付。

约束限制：

billingMode为1或2（已废弃）时生效，billingMode为1时不填写此参数时默认不会自动扣款。（已废弃：billingMode为2时不填写此参数时默认会自动扣款）。

取值范围：

  • “true”：是（自动扣款）

  • “false”：否（不自动扣款）

默认取值：

不涉及

DockerLVMConfigOverride

String

参数解释：

Docker数据盘配置项（已废弃，请使用storage字段）。默认配置示例如下：

"DockerLVMConfigOverride":"dockerThinpool=vgpaas/90%VG;kubernetesLV=vgpaas/10%VG;diskType=evs;lvType=linear"

默认配置在无VD类型磁盘时，会由于数据盘查找失败而出错，请根据真实盘符类型填写diskType。

约束限制：

不涉及

取值范围：

包含如下字段：

  • userLV（可选）：用户空间的大小，示例格式：vgpaas/20%VG

  • userPath（可选）：用户空间挂载路径，示例格式：/home/wqt-test

  • diskType：磁盘类型，目前只有evs、hdd和ssd三种格式

  • lvType：逻辑卷的类型，目前支持linear和striped两种，示例格式：striped

  • dockerThinpool：Docker盘的空间大小，示例格式：vgpaas/60%VG

  • kubernetesLV：Kubelet空间大小，示例格式：vgpaas/20%VG

默认取值：

不涉及

dockerBaseSize

Integer

参数解释：

节点上单容器的可用磁盘空间大小（已废弃，请优先使用containerBaseSize参数），单位G。

CCE节点容器运行时空间配置请参考数据盘空间分配说明。

约束限制：

  • Devicemapper模式下建议dockerBaseSize配置不超过80G，设置过大时可能会导致容器运行时初始化时间过长而启动失败，若对容器磁盘大小有特殊要求，可考虑使用挂载外部或本地存储方式代替。

  • dockerBaseSize设置仅在v1.19.16-r0、v1.21.3-r0、v1.23.3-r0及以上的集群版本中的EulerOS/HCEOS2.0节点上生效。

取值范围：

10-500。

默认取值：

不配置该值或值为0时将使用默认值：

  • Devicemapper模式下默认值为10；

  • OverlayFS模式默认不限制单容器可用空间大小。

containerBaseSize

Integer

参数解释：

节点上单容器的可用磁盘空间大小，单位G。

CCE节点容器运行时空间配置请参考数据盘空间分配说明。

约束限制：

  • Devicemapper模式下建议containerBaseSize配置不超过80G，设置过大时可能会导致容器运行时初始化时间过长而启动失败，若对容器磁盘大小有特殊要求，可考虑使用挂载外部或本地存储方式代替；Devicemapper模式在新版中仅有共池裸机使用，已逐步废弃。

  • containerBaseSize设置仅在新版本集群（v1.23.14-r0/v1.25.9-r0/v1.27.6-r0/v1.28.4-r0及以上）的EulerOS/HCEOS2.0节点上生效。

  • 更新节点池时，不支持更新此参数。

取值范围：

10-500。

默认取值：

不配置该值或值为0时将使用默认值：

  • Devicemapper模式下默认值为10；

  • OverlayFS模式默认不限制单容器可用空间大小。

publicKey

String

参数解释：

节点的公钥，应用于ssh密钥登录。

约束限制：

  • 当选择使用密钥对方式登录节点时该配置无效

  • 创建、更新节点池场景不支持该参数

取值范围：

不涉及

默认取值：

不涉及

alpha.cce/preInstall

String

参数解释：

安装前执行脚本。

输入的值需要经过Base64编码，方法如下：

echo -n "待编码内容" | base64

约束限制：

安装前/后执行脚本统一计算字符，转码后的字符总数不能超过10240。

取值范围：

不涉及

默认取值：

不涉及

alpha.cce/postInstall

String

参数解释：

安装后执行脚本。

输入的值需要经过Base64编码，方法如下：

echo -n "待编码内容" | base64

约束限制：

安装前/后执行脚本统一计算字符，转码后的字符总数不能超过10240。

取值范围：

不涉及

默认取值：

不涉及

alpha.cce/NodeImageID

String

参数解释：

节点自定义镜像ID，从IMS控制台获取，需要使用自定义镜像时使用此参数。

约束限制：

不涉及

说明：

  • 若指定了extendParam中的securityReinforcementType参数为cybersecurity，节点将开启安全等保加固功能，则节点的操作系统类型必须使用HCE2.0。

取值范围：

不涉及

默认取值：

不涉及

chargingMode

Integer

参数解释：

节点的计费模式。已废弃，请使用NodeSpec中的billingMode字段。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

agency_name

String

参数解释：

委托的名称。

委托是由租户管理员在统一身份认证服务（Identity and Access Management，IAM）上创建的，可以为CCE节点提供访问云服务器的临时凭证。

作为响应参数仅在创建节点传入时返回该字段。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

kubeReservedMem

Integer

参数解释：

节点内存预留，Kubernetes相关组件预留值。随节点规格变动，具体请参见节点预留资源策略说明。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

systemReservedMem

Integer

参数解释：

节点内存预留，系统组件预留值。随节点规格变动，具体请参见节点预留资源策略说明。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

kubeReservedCpu

Integer

参数解释：

节点CPU预留，Kubernetes相关组件预留值。单位为mcore。随节点规格变动，具体请参见节点预留资源策略说明。

约束限制：

kubeReservedCpu，systemReservedCpu之和小于节点池中节点最小CPU规格的50%。

取值范围：

不涉及

默认取值：

不涉及

systemReservedCpu

Integer

参数解释：

节点CPU预留，系统组件预留值。单位为mcore。随节点规格变动，具体请参见节点预留资源策略说明。

约束限制：

kubeReservedCpu，systemReservedCpu之和小于节点池中节点最小CPU规格的50%。

取值范围：

不涉及

默认取值：

不涉及

kubeReservedPid

Integer

参数解释：

节点PID预留，Kubernetes相关组件预留值。目的是为Kubernetes系统守护进程（如kubelet、container runtime等）预留指定数量的进程ID。

约束限制：

kubeReservedPid，systemReservedPid之和小于linux PID数量上限的50%。不同OS的kernel.pid_max可能并不相同，具体请参见修改节点进程 ID数量上限kernel.pid_max

取值范围：

[0,2097152] 注：CCE仅校验kernel.pid_max为4194304的场景，2022年1月30日及之前创建的节点和部分OS的kernel.pid_max会有所不同，若您更新过kernel.pid_max也需要保证kubeReservedPid，systemReservedPid之和小于linux PID数量上限。

默认取值：

不涉及

systemReservedPid

Integer

参数解释：

节点PID预留，系统组件预留值。目的是为OS系统守护进程（如 sshd、udev 等）预留指定数量的进程ID。

约束限制：

kubeReservedPid，systemReservedPid之和小于linux PID数量上限的50%。不同OS的kernel.pid_max可能并不相同，具体请参见修改节点进程 ID数量上限kernel.pid_max

取值范围：

[0,2097152] 注：CCE仅校验kernel.pid_max为4194304的场景，2022年1月30日及之前创建的节点和部分OS的kernel.pid_max会有所不同，若您更新过kernel.pid_max也需要保证kubeReservedPid，systemReservedPid之和小于linux PID数量上限。

默认取值：

不涉及

kubeReservedStorage

Integer

参数解释：

节点临时存储空间预留，Kubernetes组件预留值。目的是为Kubernetes系统守护进程（如kubelet、container runtime等）预留临时存储。单位为Gi。

约束限制：

kubeReservedStorage，systemReservedStorage之和小于容器组件所使用硬盘空间的50%。

取值范围：

不涉及

默认取值：

不涉及

systemReservedStorage

Integer

参数解释：

节点临时存储空间预留，系统组件预留值。目的是为OS系统守护进程（如 sshd、udev 等）预留临时存储。单位为Gi。

约束限制：

kubeReservedStorage，systemReservedStorage之和小于容器组件所使用硬盘空间的50%。

取值范围：

不涉及

默认取值：

不涉及

init-node-password

String

参数解释：

节点密码，仅作为响应参数时，固定展示星号，节点池场景响应返回中无该参数。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

securityReinforcementType

String

参数解释：

指定节点安全加固类型，当前仅支持HCE2.0镜像等保2.0三级安全加固。 等保加固会对身份鉴别、访问控制、安全审计、入侵防范、恶意代码防范进行检查并加固。详情请参见Huawei Cloud EulerOS 2.0等保2.0三级版镜像概述。

若未指定此参数，则尝试用原有的值补全。如：原先HCE2.0镜像已配置安全加固，更新节点池时未指定此参数，则仍旧保持安全加固配置，若要取消，需显式指定参数值为"null"。

约束限制：

不涉及

取值范围：

  • 空值：表示不开启等保加固

  • cybersecurity：表示开启等保加固

默认取值：

不涉及
表22 HostnameConfig

参数

参数类型

描述

type

String

参数解释：

K8S节点名称配置类型, 默认为“privateIp”。

约束限制：

  • 配置为cceNodeName的节点, 其节点名称、K8S节点名称以及虚机名称相同。节点名称不支持修改, 并且在ECS侧修改了虚机名称，同步云服务器时，不会将修改后的虚机名称同步到节点。

  • 配置为cceNodeName的节点，为了避免K8S节点名称冲突，系统会自动在节点名称后添加后缀，后缀的格式为中划线(-)+五位随机字符，随机字符的取值为[a-z0-9]。

取值范围：

  • privateIp: 将节点私有IP作为K8S节点名称

  • cceNodeName: 将CCE节点名称作为K8S节点名称

默认取值：

默认为“privateIp”。
表23 HyperNodeStatus

参数

参数类型

描述

phase

String

参数解释

超节点状态

取值范围

  • provisioning: 创建中。

  • active: 整体可用，代表超节点下所有节点都可用。

  • partially-available: 超节点下存在不可用节点时会从 active 转成此状态。

  • error: 错误状态。

  • deleting: 删除中。

  • reinstalling: 重置中。

  • scaling: 扩容或缩容中。

instanceID

String

参数解释

超节点ID

currentNode

Integer

参数解释

超节点下节点总数

deletingNode

Integer

参数解释

超节点下处于删除中的节点数

creatingNode

Integer

参数解释

超节点下处于创建中的节点数

activeNode

Integer

参数解释

超节点下处于可用状态的节点数

请求示例

无

响应示例

状态码：200

查询集群中超节点列表

[ {
  "kind" : "HyperNode",
  "apiVersion" : "v3",
  "metadata" : {
    "name" : "example-hypernode",
    "uid" : "ff6f0e64-5ca5-11f0-99c9-0255ac10007d",
    "creationTimestamp" : "2025-07-09 09:20:47.33121 +0000 UTC",
    "updateTimestamp" : "2025-07-09 09:41:21.179737 +0000 UTC"
  },
  "spec" : {
    "flavor" : "kat3ne-8-800t.48xlarge.8.matrix_0507_cy",
    "nodepoolID" : "a7ff7919-564a-11f0-97e8-0255ac10007d",
    "nodeTemplate" : {
      "az" : "cn-southwest-249a",
      "os" : "Huawei Cloud EulerOS 2.0",
      "login" : {
        "userPassword" : {
          "username" : "root",
          "password" : "******"
        }
      },
      "rootVolume" : {
        "volumetype" : "SSD",
        "size" : 50
      },
      "dataVolumes" : [ {
        "volumetype" : "SSD",
        "size" : 100,
        "hw:passthrough" : true
      } ],
      "storage" : {
        "storageSelectors" : [ {
          "name" : "cceUse",
          "storageType" : "evs",
          "matchLabels" : {
            "count" : "1",
            "size" : "100",
            "volumeType" : "SSD"
          }
        } ],
        "storageGroups" : [ {
          "name" : "vgpaas",
          "cceManaged" : true,
          "selectorNames" : [ "cceUse" ],
          "virtualSpaces" : [ {
            "name" : "share",
            "size" : "100%",
            "lvmConfig" : {
              "lvType" : "linear"
            }
          } ]
        } ]
      },
      "k8sTags" : {
        "accelerator/huawei-npu" : "",
        "cce.cloud.com/cce-nodepool" : "hypernode-nodepool-wx-test-update-2",
        "test" : "abcd",
        "volcano.sh/hypercluster" : "50e537b1-57f8-4930-a308-b14cbadf1fa4",
        "volcano.sh/hypernode" : "ff6f0e64-5ca5-11f0-99c9-0255ac10007d"
      },
      "runtime" : {
        "name" : "containerd"
      },
      "extendParam" : {
        "alpha.cce/NodeImageID" : "17ce78b8-3b55-42f7-a818-3210539b36b1",
        "alpha.cce/postInstall" : "ZWNobyBoZWxsbyA+IC9wb3N0LnR4dA==",
        "alpha.cce/preInstall" : "ZWNobyBoZWxsbyA+IC9wcmUudHh0",
        "containerBaseSize" : 10,
        "maxPods" : 32,
        "publicKey" : ""
      },
      "hostnameConfig" : { }
    },
    "chargeMode" : "prepaid"
  },
  "status" : {
    "phase" : "partially-available",
    "instanceID" : "2dc90f06-198a-40de-96de-644025985cfb",
    "currentNode" : 1,
    "deletingNode" : 0,
    "creatingNode" : 0,
    "activeNode" : 0,
    "isStatic" : true
  }
} ]

SDK代码示例

SDK代码示例如下。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
 
package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.cce.v3.region.CceRegion;
import com.huaweicloud.sdk.cce.v3.*;
import com.huaweicloud.sdk.cce.v3.model.*;


public class ListHyperNodesSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        String projectId = "{project_id}";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        CceClient client = CceClient.newBuilder()
                .withCredential(auth)
                .withRegion(CceRegion.valueOf("<YOUR REGION>"))
                .build();
        ListHyperNodesRequest request = new ListHyperNodesRequest();
        request.withClusterId("{cluster_id}");
        try {
            ListHyperNodesResponse response = client.listHyperNodes(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
 
# coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkcce.v3.region.cce_region import CceRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkcce.v3 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

    client = CceClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(CceRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = ListHyperNodesRequest()
        request.cluster_id = "{cluster_id}"
        response = client.list_hyper_nodes(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
 
package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    cce "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    projectId := "{project_id}"

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        Build()

    client := cce.NewCceClient(
        cce.CceClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.ListHyperNodesRequest{}
	request.ClusterId = "{cluster_id}"
	response, err := client.ListHyperNodes(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

更多编程语言的SDK代码示例，请参见API Explorer的代码示例页签，可生成自动对应的SDK代码示例。

状态码

状态码

描述

200

查询集群中超节点列表

错误码

请参见错误码。

父主题： 节点管理

相关文档