Obtaining the Supernode List in a Cluster

project_id

Yes

String

Details:

Project ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI.

Constraints:

None

Options:

Project IDs of the account

Default value:

N/A

cluster_id

Yes

String

Details:

Cluster ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI.

Constraints:

None

Options:

Cluster IDs

Default value:

N/A

limit

No

Integer

Definition

Number of data records displayed on each page

Constraints

N/A

Range

An integer ranging from 1 to 1000

Default Value

100

offset

No

Integer

Definition

The number of data records to skip for pagination. For example, entering 0 displays the first record. Entering 10 skips the first 10 records and displays the 11th. If no value is entered, the parameter will default to 0 and the first record is shown by default.

Constraints

N/A

Range

A 32-bit non-negative integer

Default Value

0

[items]

Array of HyperNode objects

Definition:

Hypernode

Range:

N/A

apiVersion

String

Definition:

API version. The value is fixed at v3.

Range:

• v3

kind

String

Definition:

API type. The value is fixed at HyperNode.

Range:

• HyperNode

metadata

HyperNodeMetadata object

Definition:

Hypernode metadata

Range:

N/A

spec

HyperNodeSpec object

Definition:

Hypernode information

Range:

N/A

status

HyperNodeStatus object

Definition:

Hypernode status

Range:

N/A

name

String

Definition:

Hypernode name

Range:

Enter 1 to 69 characters that start with a lowercase letter and not end with a hyphen (-). Only lowercase letters, digits, and hyphens (-) are allowed.

uid

String

Definition:

Hypernode ID, which is unique and automatically generated after the creation. A specified ID will not take effect.

Range:

The value is in UUID format.

creationTimestamp

String

Definition:

Creation time, which is automatically generated after creation. A specified value does not take effect.

Range:

N/A

updateTimestamp

String

Definition:

Update time, which is automatically generated by the system. A specified value does not take effect.

Range:

N/A

ownerReference

ownerReference object

Definition:

Owner object.

Range:

N/A

nodepoolName

String

Definition:

Node Pool Name

Range:

N/A

nodepoolID

String

Definition:

Node pool ID

Range:

N/A

flavor

String

Definition:

Hypernode specifications

Range:

N/A

nodepoolID

String

Definition:

Node pool ID

Range:

N/A

nodeTemplate

Array of NodeTemplateInHyperNode objects

Definition:

Node configurations under a hypernode

Range:

N/A

chargeMode

String

Definition:

Billing mode

Range:

• prepaid: yearly/monthly billing

• postpaid: pay-per-use billing

az

String

Definition:

AZ that a node on a hypernode belongs to.

(tag:hws)

For details about AZs supported by CCE, see Regions and Endpoints.

Range:

N/A

os

String

Definition:

OS type of a node on a hypernode. For details about the supported OSs, see Node OSs.

Range:

N/A

login

Login object

Definition:

Node login mode

Range:

N/A

rootVolume

Volume object

Definition:

System disk information of a node

Range:

N/A

dataVolumes

Array of Volume objects

Definition:

Data disk parameters of a node

Range:

N/A

storage

Storage object

Definition:

Disk initialization management parameter.

This parameter is complex to configure. For details, see Attaching Disks to a Node.

Range:

N/A

k8sTags

Map<String,String>

Definition:

Kubernetes tags delivered to a node during the hypernode creation. The tags are key-value pairs.

Example:

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

Range:

N/A

runtime

Runtime object

Definition:

Container Runtime

Range:

N/A

extendParam

NodeExtendParam object

Definition:

Extended parameters for creating a node

Range:

N/A

hostnameConfig

HostnameConfig object

Definition:

Kubernetes node name configuration

Range:

N/A

sshKey

String

Details:

Name of the key pair used for login

Options:

N/A

Default value:

N/A

userPassword

UserPassword object

Definition:

Password used for node login

Range:

N/A

removeUserPassword

Boolean

Definition

Whether to remove the password login setting of a node pool during the node pool update

true, no user password can be specified.

Range

N/A

removeSSHKey

Boolean

Definition

Whether to remove the key pair login setting of a node pool during the node pool update

true, no SSH key can be specified.

Range

N/A

username

String

Details:

Login account. The default value is root.

Options:

N/A

Default value:

root

password

String

Details:

Login password. If a username and password are used when a node is created, this field is shielded in the response body.

password field must be salted during node creation. For details, see Adding a Salt in the password Field When Creating a Node.

Options:

A password must:

• Contain 8 to 26 characters.

• Contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters !@$%^-_=+[{}]:,./?

• Not contain the username or the username spelled backwards.

Default value:

N/A

size

Integer

Definition

Disk size, in GiB

Range

• System disk: 40 to 1024

• The first data disk: 20 to 32768 (When storage is set to its default value, this value range becomes 100 to 32768.)

• Other data disks: 10 to 32768 (When storage is set to its default value, this value range becomes 100 to 32768.)

volumetype

String

Details:

Disk type. For details about possible values, see the root_volume parameter in the API used to create an ECS.

Options:

• SAS: high I/O SAS disks

• SSD: ultra-high I/O SSD disks

• SATA: common I/O SATA disks. SATA disks have been removed from EVS. You can find them attached only to existing nodes.

Default value:

N/A

extendParam

Map<String,Object>

Definition:

Extended disk parameters, defined in extendparam in the API used to create an ECS.

For details, see extendparam Field Description for Creating Disks.

Range:

N/A

cluster_id

String

Details:

ID of the storage pool used by the ECS system disk. This field is used only for DeC clusters and functions as dssPoolID, that is, the ID of the DSS storage pool.

To obtain the value, see the ID field in the API used to obtain details of a DSS storage pool.

Options:

N/A

Default value:

N/A

cluster_type

String

Details:

Storage class of the ECS system disk

Options:

This field is used only for DeC clusters, and the value is always dss.

Default value:

N/A

hw:passthrough

Boolean

Details:

• Pay attention to this field if your ECS is SDI-compliant. If the value of this field is true, the created disk is of SCSI type.

• If the node pool type is ElasticBMS, this field must be set to true.

• If the node specification involves both local and EVS disks, configure the disk initialization parameters. For details, see Attaching Disks to a Node.

Options:

N/A

Default value:

N/A

metadata

VolumeMetadata object

Definition:

EVS disk encryption information. This parameter is mandatory only when the system disk or data disk of the node to be created needs to be encrypted.

Range:

N/A

__system__encrypted

String

Details:

Whether an EVS disk is encrypted. The value 0 indicates that the EVS disk is not encrypted, and the value 1 indicates that the EVS disk is encrypted.

Options:

N/A

Default value:

If this parameter does not appear, the disk is not encrypted.

__system__cmkid

String

Details:

CMK ID, which indicates encryption in metadata. This field is used with __system__encrypted.

Options:

N/A

Default value:

N/A

storageSelectors

Array of StorageSelectors objects

Definition:

Disk selection. Matched disks are managed based on matchLabels and storageType settings. Disks are matched in sequence. The matching rule in the front is matched first.

Range:

N/A

storageGroups

Array of StorageGroups objects

Definition:

A storage group consisting of multiple storage devices. It is used to divide storage space.

Range:

N/A

name

String

Details:

Name of a selector, which is used as the index of selectorNames in storageGroup.

Options:

N/A

Default value:

N/A

storageType

String

Details:

Storage type

name must be cceUse.

Options:

Only evs (EVS disks), local (local disks), and system (system disks) are supported.

Default value:

N/A

matchLabels

matchLabels object

Details:

Matching field of an EVS disk

storageType is set to system (system disk), you do not need to configure this parameter.

Options:

The size, volumeType, metadataEncrypted, metadataCmkid, and count fields in DataVolume are supported.

Default value:

N/A

size

String

Details:

Matched disk size, for example, 100. If this parameter is left blank, the disk size is not limited.

Options:

N/A

Default value:

N/A

volumeType

String

Definition

EVS disk type. Supported types include SSD, GPSSD, SAS, ESSD, and SATA. If this parameter is left empty, there is no restriction on the EVS disk type.

Range

N/A

metadataEncrypted

String

Details:

Disk encryption identifier. If this parameter is set to 0, it specifies that the disk is not encrypted. If this parameter is set to 1, it specifies that the disk is encrypted. If this parameter is left blank, there is no restriction on the disk encryption identifier.

Options:

N/A

Default value:

N/A

metadataCmkid

String

Details:

CMK ID of an encrypted disk. The value is a string of 36 bytes. If this parameter is left blank, there is no restriction on the disk key ID.

Options:

N/A

Default value:

N/A

count

String

Details:

Number of disks to be selected. If this parameter is left blank, all disks of this type are selected.

Options:

N/A

Default value:

N/A

name

String

Details:

Name of a virtual storage group, which must be unique

Options:

• If cceManaged is set to true, the name field must be set to vgpaas.

• If the data disk is used as a temporary storage volume, the name field must be set to vg-everest-localvolume-ephemeral.

• If the data disk is used as a persistent storage volume, the name field must be set to vg-everest-localvolume-persistent.

Default value:

N/A

cceManaged

Boolean

Details:

Storage space to which Kubernetes and runtime belong. Only one group is set to true. If this parameter is left blank, the default value false is used.

Options:

N/A

Default value:

N/A

selectorNames

Array of strings

Definition:

Corresponds to name in storageSelectors. One group can select multiple selectors, but one selector can be selected by only one group.

system, only one selector can be selected for a group.

Range:

N/A

virtualSpaces

Array of VirtualSpace objects

Definition:

Detailed management of space configurations in a group

Range:

N/A

name

String

Details:

Name of a virtualSpace. Only types of share, kubernetes, runtime, and user are supported.

Options:

• Kubernetes: Kubernetes space configuration. lvmConfig needs to be configured.

• runtime: runtime space configuration. runtimeConfig needs to be configured.

• user: user space configuration. lvmConfig needs to be configured.

Default value:

N/A

size

String

Details:

Size of a virtualSpace. The value must be an integer in percentage, for example, 90%.

Options:

10 to 90. The sum of percentages of all virtualSpaces in a group cannot exceed 100%.

Default value:

N/A

lvmConfig

LVMConfig object

Definition:

LVM configuration management, which is applicable to share, Kubernetes, and user space configuration

Range:

N/A

runtimeConfig

RuntimeConfig object

Definition:

Runtime configuration management, which is applicable to runtime space configuration

Range:

N/A

lvType

String

Details:

LVM write mode. linear indicates the linear mode. striped indicates the striped mode, in which multiple disks are used to form a strip to improve disk performance.

Options:

N/A

Default value:

N/A

path

String

Details:

Disk mount path. This parameter only takes effect in user configuration. The value can be an absolute path containing digits, uppercase letters, lowercase letters, periods (.), hyphens (-), and underscores (_).

Options:

N/A

Default value:

N/A

lvType

String

Details:

LVM write mode. linear indicates the linear mode. striped indicates the striped mode, in which multiple disks are used to form a strip to improve disk performance.

Options:

N/A

Default value:

N/A

name

String

Details:

Container runtime

Options:

N/A

Default value:

• Clusters earlier than v1.25: The default value is docker.

• Clusters of v1.25 or later: The default value varies with the OSs.

• For nodes running EulerOS 2.5 or EulerOS 2.8, the default value is docker. For nodes running other OSs, the default value is containerd.

runtimeClass

String

Definition

Container runtime subtype

Range

• runc: common runtime

• kata: secure runtime. This option requires c6 or c7 series ECSs (PMs) and supports EulerOS 2.10.

• kuasar-vmm: secure runtime v2. This option requires Huawei Cloud EulerOS 2.0 and clusters of v1.28.15-r70, v1.29.15-r30, v1.30.14-r30, v1.31.10-r30, v1.32.6-r30, v1.33.5-r20, or later.

ecs:performancetype

String

Definition

Type of a cloud server flavor. This field is returned in the response.

Range

For details about the ECS flavor types, see the description of the ecs:performancetype parameter in the API for listing flavor details and extended information in the ECS API Reference.

]

For details, see Listing Flavor Details and Extended Information.]

orderID

String

Definition

Order ID

Range

N/A

productID

String

Definition

Product ID

Range

N/A

maxPods

Integer

Definition

The maximum number of pods that can be created on a node, including the default system pods.

This limit prevents the node from being overloaded with pods.

The number of pods that can be created on a node is determined by multiple parameters. For details, see Maximum Number of Pods That Can Be Created on a Node.

Range

Typically, the value ranges from 16 to 256. For nodes using secure runtime v2 (kuasar-vmm), the value ranges from 16 to 1024.

periodType

String

Details:

Subscription term unit

billingMode is set to 1 (yearly/monthly billing) or 2 (yearly/monthly billing with auto payment enabled) (This option has been deprecated).

• As a response parameter, it is returned only when a yearly/monthly node is created.

Options:

• month

• year

Default value:

N/A

periodNum

Integer

Details:

Number of subscription periods

billingMode is set to 1 (yearly/monthly billing) or 2 (yearly/monthly billing with auto payment enabled) (This option has been deprecated).

• As a response parameter, it is returned only when a yearly/monthly node is created.

Options:

• If periodType is month, the value ranges from 1 to 9.

• If periodType is year, the value ranges from 1 to 3.

Default value:

N/A

isAutoRenew

String

Details:

Whether auto-renewal is enabled

billingMode is set to 1 or 2 (deprecated). If not specified, auto-renewal is not enabled.

Options:

• true: Auto-renewal is enabled.

• false: Auto-renewal is not enabled.

Default value:

N/A

isAutoPay

String

Details:

Whether an order is automatically or manually paid

billingMode is set to 1 or 2 (deprecated). If not specified when billingMode is set to 1, auto payment is not enabled. If not specified when billingMode is set to 2 (deprecated), auto payment is enabled.

Options:

• true: Auto payment is enabled.

• false: Auto payment is not enabled.

Default value:

N/A

DockerLVMConfigOverride

String

Details:

Docker data disk configuration item. (This parameter has been deprecated. Use the storage field instead.) Example of the default configuration:

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

By default, if no VD disk is available, an error occurs because the data disk fails to be found. Specify diskType based on the actual drive letter type.

Options:

The following fields are included:

• userLV: (Optional) size of the user space, for example, vgpaas/20%VG

• userPath (Optional): mount path of the user space, for example, /home/wqt-test

• diskType: disk type. Only evs, hdd, and ssd are supported.

• lvType: type of a logic volume. The value can be linear or striped.

• dockerThinpool: Docker space size, for example, vgpaas/60%VG

• kubernetesLV: kubelet space size, for example, vgpaas/20%VG

Default value:

N/A

dockerBaseSize

Integer

Definition

Available disk space of a single container on a node (unit: G). This parameter has been deprecated. Use containerBaseSize.

For details about how to allocate the space for the container runtime, see Data Disk Space Allocation.

dockerBaseSize be set to a value less than or equal to 80 GiB. If the value is too large, the container runtime may fail to be started due to time-consuming initialization. If there are special requirements for the container disk space, you can mount external or local storage.

• dockerBaseSize takes effect only on nodes running EulerOS or Huawei Cloud EulerOS 2.0 in clusters of v1.19.16-r0, v1.21.3-r0, v1.23.3-r0, or later.

Range

10 to 500

0, the default value is used.

• The default value is 10 in Device Mapper mode.

• In OverlayFS mode, no fixed upper limit is imposed on the available space of a single container.

containerBaseSize

Integer

Details:

Available disk space of a single container on a node (unit: G).

For details about how to allocate the space for the container runtime, see Space Allocation of a Data Disk.

containerBaseSize be set to a value less than or equal to 80 GiB. If the value is too large, the container runtime may fail to be started due to long initialization. If there are special requirements for the container disk space, you can mount an external or local storage device. In new versions, the Device Mapper mode is used only by BMSs in the same resource pool and is being deprecated.

• The containerBaseSize setting takes effect only on nodes running EulerOS or Huawei Cloud EulerOS 2.0 in clusters of the new version (v1.23.14-r0, v1.25.9-r0, v1.27.6-r0, v1.28.4-r0 or later).

• This parameter cannot be updated when a node pool is being updated.

Options:

10 to 500

Default value:

If the value is not specified or is set to 0, the default value is used.

• The default value is 10 in Device Mapper mode.

• In OverlayFS mode, the available space of a single container is not limited by default.

publicKey

String

Definition

Public key of a node, which is used for SSH key login

Range

N/A

alpha.cce/preInstall

String

Details:

Pre-installation script.

The input value must be encoded using Base64. The method is as follows:

echo -n "*Content to be encoded*" | base64

Options:

N/A

Default value:

N/A

alpha.cce/postInstall

String

Details:

Post-installation script.

The input value must be encoded using Base64. The method is as follows:

echo -n "*Content to be encoded*" | base64

Options:

N/A

Default value:

N/A

alpha.cce/NodeImageID

String

Definition

Private image ID of a node, which is obtained from the IMS console. This parameter is required when private images are used.

Range

N/A

chargingMode

Integer

Details:

Billing mode of a node. This parameter has been deprecated. Use billingMode in NodeSpec instead.

Options:

N/A

Default value:

N/A

marketType

String

Details:

When creating a spot ECS, this parameter should be set to spot.

billingMode is set to 0.

Options:

N/A

Default value:

N/A

spotPrice

String

Details:

The highest price per hour a user accepts for a spot ECS

billingMode is set to 0 and marketType is set to spot.

• When billingMode is set to 0 and marketType is set to spot, if spotPrice is not specified, the pay-per-use price is used by default.

• The spotPrice value must be less than or equal to the pay-per-use price and greater than or equal to the ECS market price.

Options:

N/A

Default value:

N/A

agency_name

String

Details:

Agency name.

An agency is created by a tenant administrator on Identity and Access Management (IAM) to provide temporary credentials for CCE nodes to access cloud servers.

This parameter is returned only when it is transferred during node creation.

Options:

N/A

Default value:

N/A

kubeReservedMem

Integer

Details:

Reserved node memory, which is reserved for Kubernetes components.

Options:

N/A

Default value:

N/A

systemReservedMem

Integer

Details:

Reserved node memory, which is reserved for system components.

Options:

N/A

Default value:

N/A

kubeReservedCpu

Integer

Definition

Reserved node CPU cores for Kubernetes components. The unit is mcore.

kubeReservedCpu and systemReservedCpu is less than 50/ %of the minimum CPUs of the nodes in a node pool.

Range

N/A

systemReservedCpu

Integer

Definition

Reserved node CPU cores for system components. The unit is mcore.

kubeReservedCpu and systemReservedCpu is less than 50/ %of the minimum CPUs of the nodes in a node pool.

Range

N/A

kubeReservedPid

Integer

Definition

Reserved node PIDs for Kubernetes components. The purpose is to reserve a specified number of PIDs for Kubernetes daemons, such as kubelet and container runtime.

kubeReservedPid and systemReservedPid is less than 50/ %of the maximum number of Linux PIDs.

Range

[0,2097152] Note: CCE verifies only the scenario where kernel.pid_max is 4194304. The kernel.pid_max of nodes created on or before January 30, 2022 is different from that of some OSs. If you have updated kernel.pid_max, ensure that the sum of kubeReservedPid and systemReservedPid is less than the upper limit of the number of Linux PIDs.

systemReservedPid

Integer

Definition

Reserved node PIDs for system components. The purpose is to reserve a specified number of PIDs for the OS daemons, such as sshd and udev.

kubeReservedPid and systemReservedPid is less than 50/ %of the maximum number of Linux PIDs.

Range

[0,2097152] Note: CCE verifies only the scenario where kernel.pid_max is 4194304. The kernel.pid_max of nodes created on or before January 30, 2022 is different from that of some OSs. If you have updated kernel.pid_max, ensure that the sum of kubeReservedPid and systemReservedPid is less than the upper limit of the number of Linux PIDs.

kubeReservedStorage

Integer

Definition

Reserved temporary storage space of a node for Kubernetes components. The unit is Gi. The purpose is to reserve temporary storage for Kubernetes daemons, such as kubelet and container runtime.

kubeReservedStorage and systemReservedStorage is less than 50/ %of the disk space used by container components.

Range

N/A

systemReservedStorage

Integer

Definition

Reserved temporary storage space of a node for system components. The unit is Gi. The purpose is to reserve temporary storage for OS daemons, such as sshd and udev.

kubeReservedStorage and systemReservedStorage is less than 50/ %of the disk space used by container components.

Range

N/A

init-node-password

String

Definition

Node password. If this parameter is used only in a response, asterisks (*) are displayed. It is not returned in the responses related to node pools.

Range

N/A

serverMetadataHttpTokens

String

Definition

Whether a token is required. The default value is optional.

Range

• optional: No token is required.

• required: A token is required, which means IMDS v1 is disabled and IMDS v2 is enabled.

type

String

Details:

Configuration type of the Kubernetes node name. The default value is privateIp.

cceNodeName are the same. Node names cannot be changed. Once a VM name is altered on the ECS console, the node name cannot be modified accordingly during ECS synchronization.

• To prevent conflicts between Kubernetes node names, a suffix is automatically added to the node name of a node configured with cceNodeName. The suffix consists of a hyphen (-) followed by five random lowercase letters and digits (0 to 9).

Options:

• privateIp: Use the private node IP address the as the Kubernetes node name.

• cceNodeName: Use the CCE node name as the Kubernetes node name.

Default value:

privateIp

phase

String

Definition:

Hypernode status

Range:

• provisioning: The hypernode is being created.

• active: All nodes on the hypernode are available.

• partially-available: Some nodes on the hypernode are unavailable.

• error: An error occurred on the hypernode.

• deleting: The hypernode is being deleted.

• reinstalling: The hypernode is being reset.

• scaling: The hypernode is being scaled in or out.

instanceID

String

Definition:

Hypernode ID

Range:

N/A

currentNode

Integer

Definition:

Total number of nodes on a hypernode

Range:

An integer greater than or equal to 0

deletingNode

Integer

Definition:

Number of nodes being deleted from a hypernode

Range:

An integer greater than or equal to 0

creatingNode

Integer

Definition:

Number of nodes being created on a hypernode

Range:

An integer greater than or equal to 0

activeNode

Integer

Definition:

Number of available nodes on a hypernode

Range:

An integer greater than or equal to 0

200

The supernode list in the cluster has been obtained.