Listing All Node Pools in a Specified Cluster
Function
This API is used to obtain information about all node pools in a specified cluster.
-
The URL for cluster management is in the format of https://Endpoint/uri. In the URL, uri indicates the resource path, that is, the path for API access.
-
A node pool is a group of nodes within a cluster that all have the same configuration.
Calling Method
For details, see Calling APIs.
URI
GET /api/v3/projects/{project_id}/clusters/{cluster_id}/nodepools
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
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 |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
showDefaultNodePool |
No |
String |
Whether to display the default node pool. By default, the default node pool is not displayed. If this parameter is set to true, the default node pool is displayed. |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
Content-Type |
Yes |
String |
Details: Request body type or format Constraints: The GET method is not verified. Options:
Default value: N/A |
X-Auth-Token |
Yes |
String |
Details: Requests for calling an API can be authenticated using either a token or AK/SK. If token-based authentication is used, this parameter is mandatory and must be set to a user token. For details, see Obtaining a User Token. Constraints: None Options: N/A Default value: N/A |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
kind |
String |
API type. The value is fixed to List. |
apiVersion |
String |
API version. The value is fixed to v3. |
items |
Array of NodePoolResp objects |
/ |
Parameter |
Type |
Description |
---|---|---|
kind |
String |
Details: API type Constraints: The value cannot be changed. Options: N/A Default value: NodePool |
apiVersion |
String |
Details: API version Constraints: The value cannot be changed. Options: N/A Default value: v3 |
metadata |
NodePoolMetadata object |
Details: Metadata of a node pool Constraints: None |
spec |
NodePoolSpec object |
Details: Node pool specifications Constraints: This field is optional for updating a node pool. |
status |
NodePoolStatus object |
Details: Node pool status Constraints: None |
Parameter |
Type |
Description |
---|---|---|
name |
String |
Details: Node pool name Constraints: You cannot create node pools named DefaultPool. Options: Enter 1 to 50 characters starting with a lowercase letter and not ending with a hyphen (-). Only lowercase letters, digits, and hyphens (-) are allowed. Default value: N/A |
uid |
String |
Details: UID of a node pool Constraints: The value is automatically generated after the object is created. A user-defined value will not take effect. Options: N/A Default value: N/A |
annotations |
Map<String,String> |
Details: Annotations of a node pool in key-value pairs Constraints: This parameter is used only for query and cannot be input through a request. Entered data of this parameter is invalid. |
updateTimestamp |
String |
Details: Time when a node pool was updated Constraints: The value is automatically recorded when a node pool is updated and cannot be specified. Options: N/A Default value: N/A |
creationTimestamp |
String |
Details: Time when a node pool was created Constraints: The value is automatically recorded when a node pool is created and cannot be specified. Options: N/A Default value: N/A |
Parameter |
Type |
Description |
---|---|---|
type |
String |
Details: Node pool type Constraints: None Options:
Default value: vm |
nodeTemplate |
NodeSpec object |
Details: Detailed parameters of a node pool template Constraints: None |
initialNodeCount |
Integer |
Details: The initial number of nodes in a node pool. The obtained value is the desired number of nodes in the node pool. Constraints: None Options: Values that are greater than or equal to 0 and less than or equal to the cluster scale Default value: 0 |
autoscaling |
NodePoolNodeAutoscaling object |
Details: Auto scaling parameters Constraints: None |
nodeManagement |
NodeManagement object |
Details: Node management configuration Constraints: None |
podSecurityGroups |
Array of SecurityID objects |
Details: Security group configuration Constraints: None |
extensionScaleGroups |
Array of ExtensionScaleGroup objects |
Details: Configuration list of the extended scaling groups in a node pool. For details, see the definition of ExtensionScaleGroup. Constraints: None |
customSecurityGroups |
Array of strings |
Details: Custom security group configuration for a node pool. New nodes added to a node pool can be bound to a specified security group.
Constraints: None |
Parameter |
Type |
Description |
---|---|---|
flavor |
String |
Details: Node flavors. For details about the node flavors supported by CCE clusters, see Node Specifications. Constraints: None Options: N/A Default value: N/A |
az |
String |
Details: AZ where the node to be created is located. You need to specify the AZ name. Random AZs will not be allocated to a node created using APIs. For details about AZs supported by CCE, see Regions and Endpoints. Constraints: When you are creating a node pool and configuring a scaling group, this parameter cannot be set to random. Options: N/A Default value: N/A |
os |
String |
Details: Node OS. For details about the supported OSs, see Node OSs. Constraints:
Options: N/A Default value: N/A |
login |
Login object |
Details: Node login mode. Either the key pair or password must be used for login. Constraints: This parameter cannot be modified when a node pool is being updated. |
rootVolume |
Volume object |
Details: Disk information of a node Constraints: None |
dataVolumes |
Array of Volume objects |
Details: Data disk parameters of a node. For DeC nodes, the parameter details are the same as those in rootVolume. Constraints: A VM can have up to 16 disks attached, while a BMS can only have up to 10 disks attached. The maximum number of disks that can be attached to either a VM or BMS is limited by their respective maximum disk limits. (You can add more data disks to each of your nodes through the CCE console or APIs.) The data disk used by the container runtime and kubelet cannot be detached, or the node will become unavailable. |
storage |
Storage object |
Details: Disk initialization management parameter. This parameter is complex to configure. For details, see Attaching Disks to a Node. Constraints:
|
publicIP |
NodePublicIP object |
Details: EIP of a node Constraints: This parameter is not supported when you add a node during node pool creation. |
nodeNicSpec |
NodeNicSpec object |
Details: ENI of a node Constraints: None |
count |
Integer |
Details: Number of nodes to be created in batches Constraints: This parameter can be left blank when it is used for a node pool. Options: Positive integers that are greater than or equal to 1 and less than or equal to the maximum limit Default value: N/A |
billingMode |
Integer |
Details: Billing mode of a node Constraints: None Options:
Default value: N/A |
taints |
Array of Taint objects |
Details: Taints, which can be added to nodes for anti-affinity configuration. Each taint contains the following parameters:
Example: "taints": [{ "key": "status", "value": "unavailable", "effect": "NoSchedule" }, { "key": "looks", "value": "bad", "effect": "NoSchedule" }] Constraints: A maximum of 20 taints can be configured. |
k8sTags |
Map<String,String> |
Details: Defined in key-value pairs.
Example: "k8sTags": { "key": "value" } Constraints: A maximum of 20 key-value pairs are allowed. |
ecsGroupId |
String |
Details: ECS group ID. If this parameter is specified, nodes will be created in the specific ECS group. Constraints: This configuration does not take effect when a node pool is created. To ensure that all nodes in a node pool are in the same ECS group, configure nodeManagement in the node pool. Options: N/A Default value: N/A |
dedicatedHostId |
String |
Details: ID of the DeH to which nodes will be scheduled. Constraints: This parameter is not supported when you add a node during node pool creation. |
userTags |
Array of UserTag objects |
Details: Cloud server tag (resource tag). When creating a node, you can specify the initial value for this parameter and this field is not returned during query. In node pools, the initial value can be specified in the node template and this field is returned during query. In other scenarios, this field is not returned during query. Constraints:
|
runtime |
Runtime object |
Details: Container runtime
Constraints: None |
initializedConditions |
Array of strings |
Details: Custom initialization flag, which is left blank by default. Before CCE nodes are initialized, they are tainted with node.cloudprovider.kubernetes.io/uninitialized to prevent pods from being scheduled to them. When creating a node, you can specify the initializedConditions parameter to control the taint removal time. By default, the timeout interval is not configured. Example:
status: conditions: - type: CCEInitial status: 'True' - type: CustomedInitial status: 'True'
Constraints:
|
extendParam |
NodeExtendParam object |
Details: Extended parameters for creating a node Constraints: None |
hostnameConfig |
HostnameConfig object |
Details: Kubernetes node name configuration parameter Constraints: The supported cluster version is v1.23.6-r0 to v1.25 or v1.25.2-r0 or later. |
serverEnterpriseProjectID |
String |
Details: Enterprise project ID of a server. CCE does not support features provided by EPS. This field is used only for synchronizing enterprise project IDs of servers. Constraints: To create a node or node pool, you can specify an existing enterprise project for it. If this field is left blank, it inherits the enterprise project attributes of the cluster that runs the node or node pool. When updating a node pool, any configuration modifications you made will apply only to new nodes. You need to modify the enterprise projects of existing nodes on the EPS console. Options: N/A Default value: If no value is specified during update, this field will not be updated. If this parameter is left blank, the cluster enterprise project is returned. |
Parameter |
Type |
Description |
---|---|---|
sshKey |
String |
Details: Name of the key pair used for login Constraints: None Options: N/A Default value: N/A |
userPassword |
UserPassword object |
Details: Password used for node login Constraints: None |
Parameter |
Type |
Description |
---|---|---|
username |
String |
Details: Login account. The default value is root. Constraints: None 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. Constraints: The 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:
Default value: N/A |
Parameter |
Type |
Description |
---|---|---|
size |
Integer |
Details: Disk size, in GiB Constraints: None Options:
Default value: N/A |
volumetype |
String |
Details: Disk type. For details about possible values, see the root_volume parameter in the API used to create an ECS. Constraints: None Options:
NOTE:
For details about disk types, see Disk Types and Performance. Default value: N/A |
extendParam |
Map<String,Object> |
Details: Extended disk parameters, defined in extendparam in the API used to create an ECS. For details, see extendparam Field Description for Creating Disks. Constraints: None |
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. Constraints: None Options: N/A Default value: N/A |
cluster_type |
String |
Details: Storage class of the ECS system disk Constraints: None Options: This field is used only for DeC clusters, and the value is always dss. Default value: N/A |
hw:passthrough |
Boolean |
Details:
Constraints: None Options: N/A Default value: N/A |
metadata |
VolumeMetadata object |
Details: 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. Constraints: None |
Parameter |
Type |
Description |
---|---|---|
__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. Constraints: None 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. Constraints: None Options: N/A Default value: N/A |
Parameter |
Type |
Description |
---|---|---|
storageSelectors |
Array of StorageSelectors objects |
Details: 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. Constraints: None |
storageGroups |
Array of StorageGroups objects |
Details: A storage group consisting of multiple storage devices, which are used to divide storage space. Constraints: None |
Parameter |
Type |
Description |
---|---|---|
name |
String |
Details: Name of a selector, which is used as the index of selectorNames in storageGroup. Constraints: The name of each selector must be unique. Options: N/A Default value: N/A |
storageType |
String |
Details: Storage type Constraints:
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 Constraints: If 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 |
Parameter |
Type |
Description |
---|---|---|
size |
String |
Details: Matched disk size, for example, 100. If this parameter is left blank, the disk size is not limited. Constraints: None Options: N/A Default value: N/A |
volumeType |
String |
Details: EVS disk type Constraints: None Options: SSD, GPSSD, SAS, ESSD, and SATA are supported. If this parameter is left blank, there is no restriction on the disk type. Default value: 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. Constraints: None 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. Constraints: None 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. Constraints: None Options: N/A Default value: N/A |
Parameter |
Type |
Description |
---|---|---|
name |
String |
Details: Name of a virtual storage group, which must be unique Constraints: None Options:
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. Constraints: None Options: N/A Default value: N/A |
selectorNames |
Array of strings |
Details: Corresponds to name in storageSelectors. One group can select multiple selectors, but one selector can be selected by only one group. Constraints: System components cannot be separately stored in the system disk and data disks. Therefore, when the selector type is set to system, only one selector can be selected for a group. |
virtualSpaces |
Array of VirtualSpace objects |
Details: Detailed management of space configurations in a group Constraints: None |
Parameter |
Type |
Description |
---|---|---|
name |
String |
Details: Name of a virtualSpace. Only types of share, kubernetes, runtime, and user are supported. Constraints: None Options:
Default value: N/A |
size |
String |
Details: Size of a virtualSpace. The value must be an integer in percentage, for example, 90%. Constraints: None Options: 10 to 90. The sum of percentages of all virtualSpaces in a group cannot exceed 100%. Default value: N/A |
lvmConfig |
LVMConfig object |
Details: LVM configuration management, which is applicable to share, Kubernetes, and user space configuration Constraints: One virtualSpace supports only one config. |
runtimeConfig |
RuntimeConfig object |
Details: Runtime configuration management, which is applicable to runtime space configuration Constraints: One virtualSpace supports only one config. |
Parameter |
Type |
Description |
---|---|---|
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. Constraints: None 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 (_). Constraints: Do not leave the path empty or set it to a key OS path such as the root directory. Key OS paths that cannot be entered: /, /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/ Options: N/A Default value: N/A |
Parameter |
Type |
Description |
---|---|---|
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. Constraints: None Options: N/A Default value: N/A |
Parameter |
Type |
Description |
---|---|---|
ids |
Array of strings |
Details: IDs of existing EIPs Constraints:
|
count |
Integer |
Details: Number of EIPs to be dynamically created Constraints: count and eip must be configured simultaneously. Options: N/A Default value: N/A |
eip |
NodeEIPSpec object |
Details: EIP configuration Constraints: This parameter is not supported when creating a node pool. |
Parameter |
Type |
Description |
---|---|---|
iptype |
String |
Details: EIP type, specified in publicip.type in the API for assigning an EIP. For details, see Assigning an EIP. Constraints: None Options: N/A Default value: N/A |
bandwidth |
NodeBandwidth object |
Details: Bandwidth parameters of the EIP Constraints: None |
Parameter |
Type |
Description |
---|---|---|
chargemode |
String |
Details: Bandwidth billing mode
NOTE:
Constraints: None Options:
Default value: N/A |
size |
Integer |
Details: Bandwidth size, specified in bandwidth.size in the API for assigning an EIP. For details, see Assigning an EIP. Constraints: None Options: N/A Default value: N/A |
sharetype |
String |
Details: Bandwidth sharing type. Dedicated bandwidth is supported only. PER specifies dedicated bandwidth. Constraints: None Options: N/A Default value: N/A |
Parameter |
Type |
Description |
---|---|---|
primaryNic |
NicSpec object |
Details: Description of the primary ENI Constraints: None |
extNics |
Array of NicSpec objects |
Details: Extension ENI Constraints: This parameter is not supported when you add a node during node pool creation. |
Parameter |
Type |
Description |
---|---|---|
subnetId |
String |
Details: Network ID of the subnet to which an ENI belongs. If subnetList is also configured for a node pool, the subnetList field is used for adding subnets to the node pool. Constraints:
Options: N/A Default value: N/A |
fixedIps |
Array of strings |
Details: The IP address of the primary ENI is specified using fixedIps. The number of IP addresses cannot be greater than the number of created nodes. Constraints: Either fixedIps or ipBlock can be specified. fiexdIps cannot be specified for extension ENIs. |
ipBlock |
String |
Details: CIDR format of the primary ENI IP address range. The IP address of the created node falls in this range. Constraints: Either fixedIps or ipBlock can be specified. Options: N/A Default value: N/A |
subnetList |
Array of strings |
Details: Network ID list of the subnet where the ENI resides. Multiple subnets can be configured for a node pool. Constraints: A maximum of 20 subnets can be configured. |
Parameter |
Type |
Description |
---|---|---|
key |
String |
Details: Key Constraints: The value must contain 1 to 63 characters starting and ending with a letter or digit. Only letters, digits, hyphens (-), underscores (_), and periods (.) are allowed. Options: N/A Default value: N/A |
value |
String |
Details: Value Constraints: The value must contain 1 to 63 characters starting and ending with a letter or digit. Only letters, digits, hyphens (-), underscores (_), and periods (.) are allowed. Options: N/A Default value: N/A |
effect |
String |
Details: Effect Constraints: None Options: Available options are NoSchedule, PreferNoSchedule, and NoExecute. Default value: N/A |
Parameter |
Type |
Description |
---|---|---|
key |
String |
Details: Key of the cloud server tag Constraints: The value cannot start with CCE- or __type_baremetal. Options: A tag key can have a maximum of 36 characters. It can only contain letters, digits, Unicode characters, and special characters (-_). Default value: N/A |
value |
String |
Details: Value of the cloud server tag Constraints: None Options: A tag value can have a maximum of 43 characters. It can only contain letters, digits, Unicode characters, and special characters (-_). Default value: N/A |
Parameter |
Type |
Description |
---|---|---|
name |
String |
Details: Container runtime Constraints: None Options: N/A Default value:
|
Parameter |
Type |
Description |
---|---|---|
ecs:performancetype |
String |
Details: ECS flavor types. This field is returned in the response. Constraints: None Options: N/A Default value: N/A |
orderID |
String |
Details: Order ID Constraints: This parameter is returned in the response when the node is billed on a yearly/monthly basis with auto payment enabled (only in creation scenarios). Options: N/A Default value: N/A |
productID |
String |
Details: Product ID Constraints: This field is returned in the response when the node is billed on a yearly/monthly basis with auto payment enabled. Options: N/A Default value: N/A |
maxPods |
Integer |
Details: 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. Constraints: None Options: 16 to 256 Default value: N/A |
periodType |
String |
Details: Subscription period type Constraints:
Options:
Default value: N/A |
periodNum |
Integer |
Details: Number of subscription periods Constraints:
Options:
Default value: N/A |
isAutoRenew |
String |
Details: Whether auto-renewal is enabled Constraints: This field is valid when billingMode is set to 1 or 2 (discarded). If not specified, auto-renewal is not enabled. Options:
Default value: N/A |
isAutoPay |
String |
Details: Whether an order is automatically or manually paid Constraints: This field is valid when billingMode is set to 1 or 2 (discarded). If not specified when billingMode is set to 1, auto payment is not enabled. (Discarded) If not specified when billingMode is set to 2, auto payment is enabled. Options:
Default value: N/A |
DockerLVMConfigOverride |
String |
Details: Docker data disk configuration item. (This parameter has been discarded. 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. Constraints: None Options: The following fields are included:
|
dockerBaseSize |
Integer |
Details: Available disk space of a single container on a node (unit: G). This parameter has been discarded. Use containerBaseSize. For details about how to allocate the space for the container runtime, see Space Allocation of a Data Disk. Constraints: When Device Mapper is used, it is recommended that 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 long initialization. If there are special requirements for the container disk space, you can mount an external or local storage device.
Options: 10 to 500 Default value: If the value is not specified or is set to 0, the default value is used.
|
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. Constraints: When Device Mapper is used, it is recommended that 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 discarded.
Options: 10 to 500 Default value: If the value is not specified or is set to 0, the default value is used.
|
publicKey |
String |
Details: Public key of a node Constraints: None Options: N/A Default value: 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 Constraints: The characters of both the pre-installation and post-installation scripts are centrally calculated, and the total number of characters after transcoding cannot exceed 10,240. 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 Constraints: The characters of both the pre-installation and post-installation scripts are centrally calculated, and the total number of characters after transcoding cannot exceed 10,240. Options: N/A Default value: N/A |
alpha.cce/NodeImageID |
String |
Details: This parameter is required when a custom image is used to create a BMS node. Constraints: None Options: N/A Default value: N/A |
nicMultiqueue |
String |
Details:
"[{\"queue\":4}]" The following fields are included:
Constraints: This field can be configured only for BMS nodes in CCE Turbo clusters. Options: N/A Default value: N/A |
nicThreshold |
String |
Details:
"0.3:0.6"
Options: Both the thresholds are one-decimal-place values ranging from 0.0 to 1.0. The low threshold must be smaller than or equal to the high one. Default value: N/A |
chargingMode |
Integer |
Details: Billing mode of a node. This parameter has been discarded. Use billingMode in NodeSpec instead. Constraints: None Options: N/A Default value: N/A |
marketType |
String |
Details: When creating a spot ECS, this parameter should be set to spot. Constraints: This parameter is valid only when 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 Constraints:
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. Constraints: None Options: N/A Default value: N/A |
kubeReservedMem |
Integer |
Details: Reserved node memory, which is reserved for Kubernetes components. Constraints: None Options: N/A Default value: N/A |
systemReservedMem |
Integer |
Details: Reserved node memory, which is reserved for system components. Constraints: None Options: N/A Default value: N/A |
init-node-password |
String |
Details: Node password. If this parameter is used as a response parameter, asterisks (*) will be displayed. Constraints: None Options: N/A Default value: N/A |
Parameter |
Type |
Description |
---|---|---|
type |
String |
Details: Configuration type of the Kubernetes node name. The default value is privateIp. Constraints:
Options:
Default value: privateIp |
Parameter |
Type |
Description |
---|---|---|
enable |
Boolean |
Details: Whether to enable auto scaling Constraints: None Options:
Default value: false |
minNodeCount |
Integer |
Details: Minimum number of nodes that can be scaled in if auto scaling is enabled Constraints: None Options: Values that are greater than or equal to 0 and cannot be greater than the maximum number of nodes allowed by the cluster specifications Default value: 0 |
maxNodeCount |
Integer |
Details: Maximum number of nodes that can be added if auto scaling is enabled Constraints: None Options: Values that are greater than or equal to the value of minNodeCount and cannot be greater than the maximum number of nodes allowed by the cluster specifications Default value: 0 |
scaleDownCooldownTime |
Integer |
Details: How long nodes will be kept, in minutes. During this period, nodes added will not be deleted. Constraints: None Options: 0 to 2147483646 Default value: 0 |
priority |
Integer |
Details: Weight of a node pool. A node pool with a higher weight has a higher priority during scale-out. Constraints: None Options: N/A Default value: 0 |
Parameter |
Type |
Description |
---|---|---|
serverGroupReference |
String |
Details: Cloud server group ID. If this field is specified, all nodes in the node pool will be created in this group. The server group ID can be specified only when you are creating the node pool and cannot be changed. Constraints: If a cloud server group is specified, the number of nodes in the node pool cannot exceed the group quota. Options: N/A Default value: N/A |
Parameter |
Type |
Description |
---|---|---|
id |
String |
Details: Security group ID Constraints: None Options: N/A Default value: N/A |
Parameter |
Type |
Description |
---|---|---|
metadata |
ExtensionScaleGroupMetadata object |
Details: Basic information about an extended scaling group Constraints: None |
spec |
ExtensionScaleGroupSpec object |
Details: Configurations of an extended scaling group, which carry different configurations from those of the default scaling group Constraints: None |
Parameter |
Type |
Description |
---|---|---|
uid |
String |
Details: UUID of an extended scaling group, which is automatically generated by the system Constraints: None Options: N/A Default value: N/A |
name |
String |
Details: Name of an extended scaling group Constraints: The value cannot be default. Options: The value can contain a maximum of 55 characters. Only digits, lowercase letters, and hyphens (-) are allowed. Default value: N/A |
Parameter |
Type |
Description |
---|---|---|
flavor |
String |
Details: Node flavors. For details about the node flavors supported by CCE clusters, see Node Specifications. Constraints: None Options: N/A Default value: N/A |
az |
String |
Details: Node AZ Constraints: None Options: N/A Default value: If this parameter is not specified or left blank, the default scaling group configurations take effect. |
capacityReservationSpecification |
Details: Capacity reservation configurations of an extended scaling group Constraints: None |
|
autoscaling |
ScaleGroupAutoscaling object |
Details: Auto scaling configurations of an extended scaling group Constraints: None |
Parameter |
Type |
Description |
---|---|---|
id |
String |
Details: Private pool ID Constraints: This value can be ignored when preference is set to none. Options: N/A Default value: N/A |
preference |
String |
Details: Private pool capacity Constraints: If the value is none, the capacity reservation is not specified. If the value is targeted, the capacity reservation is specified. In this case, the ID cannot be left blank. Options: N/A Default value: none |
Parameter |
Type |
Description |
---|---|---|
enable |
Boolean |
Details: Whether to enable auto scaling for a scaling group Constraints: None Options:
Default value: false |
extensionPriority |
Integer |
Details: Scaling group priority. A larger value indicates a higher priority. Constraints: None Options: N/A Default value: 0 |
minNodeCount |
Integer |
Details: Minimum number of nodes that can be kept in a scaling group during auto scaling Constraints: None Options: Values that are greater than or equal to 0 and cannot be greater than the maximum number of nodes allowed by the cluster specifications Default value: 0 |
maxNodeCount |
Integer |
Details: Maximum number of nodes that can be kept in a scaling group during auto scaling Constraints: None Options: Values that are greater than or equal to the value of minNodeCount, less than or equal to the maximum number of nodes allowed by the cluster specifications, and less than or equal to the maximum number of nodes in the node pool Default value: 0 |
Parameter |
Type |
Description |
---|---|---|
currentNode |
Integer |
Details: Total number of nodes in the current node pool (excluding the nodes that are being deleted) Constraints: None Options: N/A Default value: N/A |
creatingNode |
Integer |
Details: Number of nodes that are being created in the current node pool Constraints: None Options: N/A Default value: N/A |
deletingNode |
Integer |
Details: Number of nodes that are being deleted in the current node pool Constraints: None Options: N/A Default value: N/A |
configurationSyncedNodeCount |
Integer |
Number of nodes that have synchronized with the node pool parameter configurations in the current node pool |
phase |
String |
Details: Node pool status Constraints: None Options:
NOTE:
The preceding node pool status has been discarded. It is reserved only for compatibility. Do not use it anymore. Use the following instead:
Default value: N/A |
jobId |
String |
Details: ID of a job executed on the node pool. This field is available only when the node pool is being deleted. Constraints: None Options: N/A Default value: N/A |
conditions |
Array of NodePoolCondition objects |
Details: Node pool status details. For details, see the definition of Condition. Constraints: None |
scaleGroupStatuses |
Array of ScaleGroupStatus objects |
Details: Detailed status of a scaling group. For details, see the definition of ScaleGroupStatus. Constraints: None |
Parameter |
Type |
Description |
---|---|---|
name |
String |
Details: Scaling group name Constraints: None Options: N/A Default value: N/A |
uid |
String |
Details: Scaling group UUID Constraints: None Options: N/A Default value: N/A |
creationTimestamp |
String |
Details: The time when a scaling group was created Constraints: None Options: N/A Default value: N/A |
updateTimestamp |
String |
Details: The time when a scaling group was updated Constraints: None Options: N/A Default value: N/A |
phase |
String |
Details: Scaling group status Constraints: None Options:
NOTE:
The preceding scaling group status has been discarded. It is reserved only for compatibility. Do not use it anymore. Use the following instead:
Default value: N/A |
desiredNodeCount |
Integer |
Details: Expected number of nodes in a scaling group Constraints: None Options: N/A Default value: N/A |
unpaidScaleNodeCount |
Integer |
Details: Number of nodes in an unpaid order Constraints: None Options: N/A Default value: N/A |
existingNodeCount |
existingNodeCount object |
Details: Statistics on existing nodes in a scaling group Constraints: None |
upcomingNodeCount |
upcomingNodeCount object |
Details: Statistics on the nodes to be added in a scaling group Constraints: None |
scaleDownDisabledNodeCount |
Integer |
Details: Number of nodes that cannot be deleted in a scaling group Constraints: None Options: N/A Default value: N/A |
conditions |
Array of NodePoolCondition objects |
Details: Scaling group status details. For details, see the definition of Condition. Constraints: None |
Parameter |
Type |
Description |
---|---|---|
postPaid |
Integer |
Details: Number of pay-per-use nodes Constraints: None Options: N/A Default value: N/A |
prePaid |
Integer |
Details: Number of yearly/monthly nodes Constraints: None Options: N/A Default value: N/A |
total |
Integer |
Details: Total number of pay-per-use and yearly/monthly nodes Constraints: None Options: N/A Default value: N/A |
Parameter |
Type |
Description |
---|---|---|
postPaid |
Integer |
Details: Number of pay-per-use nodes Constraints: None Options: N/A Default value: N/A |
prePaid |
Integer |
Details: Number of yearly/monthly nodes Constraints: None Options: N/A Default value: N/A |
total |
Integer |
Details: Total number of pay-per-use and yearly/monthly nodes Constraints: None Options: N/A Default value: N/A |
Parameter |
Type |
Description |
---|---|---|
type |
String |
Details: Condition type Constraints: None Options:
Default value: N/A |
status |
String |
Details: Current status of the condition Constraints: None Options:
Default value: N/A |
lastProbeTime |
String |
Details: Time when the status was last checked Constraints: None Options: N/A Default value: N/A |
lastTransitTime |
String |
Details: Time when the status was last changed Constraints: None Options: N/A Default value: N/A |
reason |
String |
Details: Reason why the status was last changed Constraints: None Options: N/A Default value: N/A |
message |
String |
Details: Detailed description of the condition Constraints: None Options: N/A Default value: N/A |
Example Requests
None
Example Responses
Status code: 200
Information about all node pools in the cluster is successfully obtained.
{ "kind" : "List", "apiVersion" : "v3", "items" : [ { "kind" : "NodePool", "apiVersion" : "v3", "metadata" : { "name" : "az1.dc1#s1.large#EulerOS 2.2", "uid" : "az1.dc1#s1.large#EulerOS 2.2" }, "spec" : { "nodeTemplate" : { "flavor" : "s1.large", "az" : "az1.dc1", "os" : "EulerOS 2.2", "login" : { "sshKey" : "KeyPair-001" }, "rootVolume" : { }, "publicIP" : { "eip" : { "bandwidth" : { } } }, "billingMode" : 0 }, "autoscaling" : { "enable" : true, "maxNodeCount" : 50 } }, "status" : { "currentNode" : 1 } } ] }
SDK Sample Code
The SDK sample code is as follows.
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 ListNodePoolsSolution { 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(); ListNodePoolsRequest request = new ListNodePoolsRequest(); request.withClusterId("{cluster_id}"); try { ListNodePoolsResponse response = client.listNodePools(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 = ListNodePoolsRequest() request.cluster_id = "{cluster_id}" response = client.list_node_pools(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.ListNodePoolsRequest{} request.ClusterId = "{cluster_id}" response, err := client.ListNodePools(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } } |
For SDK sample code of more programming languages, see the Sample Code tab in API Explorer. SDK sample code can be automatically generated.
Status Codes
Status Code |
Description |
---|---|
200 |
Information about all node pools in the cluster is successfully obtained. |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot