You can call the DescribeClusterNodePoolDetail operation to query the details of a specified node pool.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request syntax

GET /clusters/ClusterId/nodepools/NodepoolId HTTP/1.1 
Content-Type:application/json

Request parameters

Table 1. Request path parameters
Parameter Type Required Example Description
ClusterId String Yes c23421cfa74454bc8b37163fd19af****

The ID of the cluster.

NodepoolId String Yes np31da1b38983f4511b490fc62108a****

The ID of the node pool that you want to query.

Response syntax

HTTP/1.1 200 OK
Content-Type:application/json

{
  "auto_scaling" : {
    "eip_bandwidth" : Long,
    "eip_internet_charge_type" : "String",
    "enable" : Boolean,
    "is_bond_eip" : Boolean,
    "max_instances" : Long,
    "min_instances" : Long,
    "type" : "String"
  },
  "kubernetes_config" : {
    "cms_enabled" : Boolean,
    "cpu_policy" : "String",
    "labels" : [ {
      "key" : "String",
      "value" : "String"
    } ],
    "runtime" : "String",
    "runtime_version" : "String",
    "taints" : [ {
      "key" : "String",
      "value" : "String",
      "effect" : "String"
    } ],
    "user_data" : "String"
  },
  "nodepool_info" : {
    "created" : "String",
    "is_default" : Boolean,
    "name" : "String",
    "nodepool_id" : "String",
    "region_id" : "String",
    "resource_group_id" : "String",
    "type" : "String",
    "updated" : "String"
  },
  "scaling_group" : {
    "auto_renew" : Boolean,
    "auto_renew_period" : Long,
    "data_disks" : [ {
      "category" : "String",
      "size" : Long,
      "encrypted" : "String",
      "auto_snapshot_policy_id" : "String"
    } ],
    "image_id" : "String",
    "instance_charge_type" : "String",
    "instance_types" : [ "String" ],
    "multi_az_policy" : "String",
    "on_demand_base_capacity" : Long,
    "on_demand_percentage_above_base_capacity" : Long,
    "spot_instance_pools" : Long,
    "spot_instance_remedy" : Boolean,
    "compensate_with_on_demand" : Boolean,
    "period" : Long,
    "period_unit" : "String",
    "platform" : "String",
    "ram_policy" : "String",
    "spot_strategy" : "String",
    "spot_price_limit" : [ {
      "instance_type" : "String",
      "price_limit" : "String"
    } ],
    "rds_instances" : [ "String" ],
    "scaling_group_id" : "String",
    "scaling_policy" : "String",
    "security_group_id" : "String",
    "security_group_ids" : [ "String" ],
    "system_disk_category" : "String",
    "system_disk_size" : Long,
    "tags" : [ {
      "key" : "String",
      "value" : "String"
    } ],
    "vswitch_ids" : [ "String" ],
    "login_password" : "String",
    "key_pair" : "String",
    "internet_charge_type" : "String",
    "internet_max_bandwidth_out" : Long
  },
  "status" : {
    "failed_nodes" : Long,
    "healthy_nodes" : Long,
    "initial_nodes" : Long,
    "offline_nodes" : Long,
    "removing_nodes" : Long,
    "serving_nodes" : Long,
    "state" : "String",
    "total_nodes" : Long
  },
  "tee_config" : {
    "tee_enable" : Boolean
  },
  "management" : {
    "enable" : Boolean,
    "auto_repair" : Boolean,
    "upgrade_config" : {
      "auto_upgrade" : Boolean,
      "surge" : Long,
      "surge_percentage" : Long,
      "max_unavailable" : Long
    }
  }
}

Response parameters

Table 2. Response body parameters
Parameter Type Example Description
auto_scaling Object

The auto scaling configurations of the queried node pool.

eip_bandwidth Long 5

The peak bandwidth of the elastic IP address (EIP) that is associated with the node pool.

eip_internet_charge_type String PayByBandwidth

The billing method of the EIP. Valid values:

  • PayByBandwidth: pay-by-bandwidth
  • PayByTraffic: pay-by-data-transfer
enable Boolean true

Indicates whether auto scaling is enabled.

  • true: Auto scaling is enabled.
  • false: Auto scaling is disabled. If this parameter is set to false, other parameters in the auto_scaling section do not take effect.
is_bond_eip Boolean true

Indicates whether an EIP is associated with the node pool. Valid values:

  • true: An EIP is associated with the node pool.
  • false: No EIP is associated with the node pool.
max_instances Long 10

The maximum number of Elastic Compute Service (ECS) instances supported by the node pool.

min_instances Long 1

The minimum number of ECS instances that must be kept in the node pool.

type String cpu

The instance types that can be used for the auto scaling of the node pool. Valid values:

  • cpu: regular instance
  • gpu: GPU-accelerated instance
  • gpushare: shared GPU-accelerated instance
  • spot: preemptible instance
kubernetes_config Object

The configurations of the cluster where the node pool is deployed.

cms_enabled Boolean true

Indicates where the CloudMonitor agent is installed on ECS nodes of the cluster. After the CloudMonitor agent is installed, you can view monitoring information about the ECS instances in the CloudMonitor console. Installation is recommended. Valid values:

  • true: The CloudMonitor agent is installed on ECS nodes.
  • false: The CloudMonitor agent is not installed on ECS nodes.
cpu_policy String none

The CPU management policy. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later.

  • static: This policy allows pods with specific resource characteristics on the node to be granted with enhanced CPU affinity and exclusivity.
  • none: indicates that the default CPU affinity is used.
labels Array of tag

The labels of the nodes. You can add labels to the nodes in the cluster. You must add labels based on the following rules:

  • Each label is a case-sensitive key-value pair. You can add at most 20 labels.
  • A key must be unique and cannot exceed 64 characters in length. A value can be empty and cannot exceed 128 characters in length. Keys and values cannot start with aliyun, acs:, https://, or http://. For more information, see Labels and Selectors.
runtime String docker

The name of the container runtime.

runtime_version String 19.03.5

The version of the container runtime.

taints Array of taint

The taints that are added to nodes. Taints are added to nodes to prevent pods from being scheduled to inappropriate nodes. However, toleration rules allow pods to be scheduled to nodes with matching taints. For more information, see taint-and-toleration.

user_data String IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFDSyEi

The user-defined data of the node pool. For more information, see Generate user-defined data.

nodepool_info Object

The configurations of the node pool.

created String 2020-09-27T19:14:09.156823496+08:00

The time when the node pool was created.

is_default Boolean true

Indicates whether the node pool is a default node pool. An ACK cluster usually has only one default node pool. Valid values:

true: The node pool is a default node pool.

false: The node pool is not a default node pool.

name String default-nodepool

The name of the node pool.

The name must be 1 to 63 characters in length, and can contain digits, letters, and hyphens (-). It cannot start with a hyphen (-).

nodepool_id String np615c0e0966124216a0412e10afe0****

The ID of the node pool.

region_id String cn-beijing

The ID of the region where the node pool is deployed.

resource_group_id String rg-acfmyvw3wjmb****

The ID of the resource group to which the node pool belongs.

type String ess

The type of the node pool.

updated String 2020-09-27T20:37:46+08:00

The time when the node pool was last updated.

scaling_group Object

The configurations of the scaling group.

auto_renew Boolean false

Indicates whether auto-renewal is enabled for the nodes in the node pool. This parameter takes effect only when instance_charge_type is set to PrePaid. Valid values:

  • true: Auto-renewal is enabled.
  • false: Auto-renewal is disabled.
auto_renew_period Long 1

The duration of the auto-renewal. This parameter takes effect and is required only when instance_charge_type is set to PrePaid.

If PeriodUnit=Month is specified, the valid values are 1, 2, 3, 6, and 12.

data_disks Array of data_disk

The configurations of the data disks that are attached to the nodes in the node pool. The configurations include the disk type and disk size.

image_id String aliyun_2_1903_x64_20G_alibase_20200529.vhd

The ID of the custom image. You can call DescribeKubernetesVersionMetadata to query the images supported by ACK.

instance_charge_type String PostPaid

The billing method of the nodes in the node pool. Valid values:

  • PrePaid: subscription
  • PostPaid: pay-as-you-go
instance_types Array of String ecs.n4.large

The instance types of the nodes in the node pool.

multi_az_policy String BALANCE

The ECS instance scaling policy for a multi-zone scaling group. Valid values:

  • PRIORITY: The scaling group is scaled based on the VSwitchIds.N parameter. When an ECS instance cannot be created in the zone where the vSwitch with the highest priority resides, the system uses the vSwitch with the next highest priority to create the ECS instance.
  • COST_OPTIMIZED: ECS instances are created based on the vCPU unit price in ascending order. Preemptible instances are preferentially created when multiple instance types are specified in the scaling configurations. You can set the CompensateWithOnDemand parameter to specify whether to automatically create pay-as-you-go instances when preemptible instances cannot be created due to insufficient resources.
    Note COST_OPTIMIZED takes effect only when multiple instance types are specified or at least one preemptible instance type is specified.
  • BALANCE: ECS instances are evenly distributed across multiple zones specified by the scaling group. If ECS instances become imbalanced among multiple zones due to insufficient inventory, you can call RebalanceInstances of Auto Scaling (ESS) to balance the instance distribution among zones. For more information, see RebalanceInstances

Default value: PRIORITY

on_demand_base_capacity Long 0

The minimum number of pay-as-you-go instances that must be kept in the scaling group. Valid values: 0 to 1000. When the number of pay-as-you-go instances is lower than this value, pay-as-you-go instances are preferentially created to meet the required number.

on_demand_percentage_above_base_capacity Long 20

The percentage of pay-as-you-go instances among the extra instances that exceed the number specified by on_demand_base_capacity. Valid values: 0 to 100.

spot_instance_pools Long 5

The number of available instance types. The scaling group creates preemptible instances of multiple instance types at the lowest cost. Valid values: 1 to 10.

spot_instance_remedy Boolean false

Indicates whether preemptible instances are supplemented when the number of preemptible instances drops below the specified minimum number. If this parameter is set to true, when the scaling group receives a system message that a preemptible instance is to be reclaimed, the scaling group attempts to create a new instance to replace this instance. Valid values:

  • true: Supplement to preemptible instances is enabled.
  • false: Supplement to preemptible instances is disabled.
compensate_with_on_demand Boolean true

Indicates whether pay-as-you-go instances are automatically created to meet the required number of ECS instances when preemptible instances cannot be created due to reasons such as the cost or inventory availability. This parameter takes effect when multi_az_policy is set to COST_OPTIMIZED. Valid values:

  • true: Pay-as-you-go instances are automatically created to meet the required number of ECS instances when the preemptible instances cannot be created.
  • false: Pay-as-you-go instances are not created to meet the required number of ECS instances when the preemptible instances cannot be created.
period Long 0

The subscription duration of worker nodes. This parameter takes effect and is required only when instance_charge_type is set to PrePaid.

If PeriodUnit=Month is specified, the valid values are 1, 2, 3, 6, 12, 24, 36, 48, and 60.

period_unit String Month

The billing cycle of the nodes. This parameter is required if instance_charge_type is set to PrePaid.

Valid value: Month

platform String AliyunLinux

The release version of the operating system. Valid values:

  • CentOS
  • AliyunLinux
  • Windows
  • WindowsCore
ram_policy String KubernetesWorkerRole-021dc54f-929b-437a-8ae0-34c24d3e****

The name of the worker Resource Access Management (RAM) role. The RAM role is assigned to the worker nodes of the cluster to allow the worker nodes to manage ECS instances.

spot_strategy String NoSpot

The bidding policy of preemptible instances. Valid values:

  • NoSpot: non-preemptible instance.
  • SpotWithPriceLimit: specifies the highest bid for the preemptible instance.
  • SpotAsPriceGo: automatically submits bids based on the up-to-date market price.

For more information, see Preemptible instances.

spot_price_limit Array

The bid configurations of preemptible instances.

instance_type String ecs.c6.large

The instance type for preemptible instances.

price_limit String 0.39

The price limit of a preemptible instance. Unit: USD/hour.

rds_instances Array of String rm-xxx

The IDs of the ApsaraDB RDS instances.

scaling_group_id String asg-2zeieod8giqmov7z****

The ID of the scaling group.

scaling_policy String release

The scaling mode of the scaling group. Valid values:

  • release: the standard mode. ECS instances are created and released based on the resource usage.
  • recycle: the swift mode. ECS instances are created, stopped, or started during scaling events. This reduces the time required for the next scale-out event. When the instance is stopped, you are charged only for the storage service. This does not apply to ECS instances attached with local disks.
security_group_id String sg-2ze60ockeekspl3d****

The ID of the security group to which the node pool is added. If the node pool is added to multiple security groups, the first ID in the value of security_group_ids is returned.

security_group_ids Array of String sg-2ze60ockeekspl3d****

The IDs of the security groups to which the node pool is added.

system_disk_category String cloud_efficiency

The type of system disk. Valid values:

  • cloud_efficiency: ultra disk
  • cloud_ssd: standard SSD
system_disk_size Long 120

The system disk size of a worker node. Unit: GiB.

Valid values: 20 to 500

tags Array of tag

The labels that are added only to ECS instances.

A key must be unique and cannot exceed 128 characters in length. Neither keys nor values can start with aliyun or acs:. Neither keys nor values can contain https:// or http://.

vswitch_ids Array of String vsw-2ze3ds0mdip0hdz8i****

The IDs of vSwitches.

login_password String ********

The password for SSH logon. You must set this parameter or the key_pair parameter. The password must be 8 to 30 characters in length, and must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters.

For security purposes, the returned password is encrypted.

key_pair String pro-nodepool

The name of the key pair. You must set this parameter or the login_password parameter. You must set key_pair if the node pool is a managed node pool.

internet_charge_type String PayByBandwidth

The billing method of the public IP address of the node.
internet_max_bandwidth_out Long 10

The maximum outbound bandwidth of the public IP address of the node. Unit: Mbit/s. Valid values: 1 to 100.

status Object

The status details about the nodes in the node pool.

failed_nodes Long 0

The number of failed nodes.

healthy_nodes Long 3

The number of healthy nodes.

initial_nodes Long 0

The number of nodes that are being created.

offline_nodes Long 0

The number of offline nodes.

removing_nodes Long 0

The number of nodes that are being removed.

serving_nodes Long 3

The number of running nodes.

state String active

The status of the node pool. Valid values:

  • active: The node pool is active.
  • scaling: The node pool is being scaled.
  • removing: Nodes are being removed from the node pool.
  • deleting: The node pool is being deleted.
  • updating: The node pool is being updated.
total_nodes Long 3

The total number of nodes in the node pool.

tee_config Object

The configurations of confidential computing.

tee_enable Boolean false

Indicates whether confidential computing is enabled. Valid values:

  • true: Confidential computing is enabled.
  • false: Confidential computing is disabled.
management Object

The configurations of managed node pools.

enable Boolean true

Indicates whether managed node pools are enabled. Valid values:

  • true: Managed node pools are enabled.
  • false: Managed node pools are disabled. Other parameters in this section take effect only when enable=true is specified.
auto_repair Boolean true

Indicates whether auto repair is enabled. This parameter takes effect only when enable=true is specified.

  • true: Auto repair is enabled.
  • false: Auto repair is disabled.
upgrade_config Object

The configurations of auto upgrade. The configurations take effect only when enable=true is specified.

auto_upgrade Boolean true

Indicates whether auto upgrade is enabled. Valid values:

  • true: Auto upgrade is enabled.
  • false: Auto upgrade is disabled.
surge Long 5

The number of nodes that are temporarily added to the node pool during an auto upgrade.

surge_percentage Long 50

The percentage of temporary nodes to the nodes in the node pool. You must set this parameter or surge.

max_unavailable Long 1

The maximum number of nodes that can be in the unschedulable state. Valid values: 1 to 1000.

Default value: 1

Examples

Sample requests

GET /clusters/c23421cfa74454bc8b37163fd19af****/nodepools/np31da1b38983f4511b490fc62108a**** HTTP/1.1 
Content-Type:application/json

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeClusterNodePoolDetailResponse>
    <auto_scaling>
        <eip_bandwidth>5</eip_bandwidth>
        <eip_internet_charge_type>PayByBandwidth</eip_internet_charge_type>
        <enable>true</enable>
        <is_bond_eip>true</is_bond_eip>
        <max_instances>10</max_instances>
        <min_instances>1</min_instances>
        <type>cpu</type>
    </auto_scaling>
    <kubernetes_config>
        <cms_enabled>true</cms_enabled>
        <cpu_policy>none</cpu_policy>
        <labels>
            <key>env</key>
            <value>prod</value>
        </labels>
        <runtime>docker</runtime>
        <runtime_version>19.03.5</runtime_version>
        <taints>
            <key>key</key>
            <value>value</value>
            <effect>NoSchedule</effect>
        </taints>
        <user_data>IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFDSyEi</user_data>
    </kubernetes_config>
    <nodepool_info>
        <created>2020-09-27T19:14:09.156823496+08:00</created>
        <is_default>true</is_default>
        <name>default-nodepool</name>
        <nodepool_id>np615c0e0966124216a0412e10afe0****</nodepool_id>
        <region_id>cn-beijing</region_id>
        <resource_group_id>rg-acfmyvw3wjmb****</resource_group_id>
        <type>ess</type>
        <updated>2020-09-27T20:37:46+08:00</updated>
    </nodepool_info>
    <scaling_group>
        <auto_renew>false</auto_renew>
        <auto_renew_period>1</auto_renew_period>
        <data_disks>
            <category>cloud_ssd</category>
            <size>40</size>
            <encrypted>true</encrypted>
            <auto_snapshot_policy_id>sp-2zej1nogjvovnz4z****</auto_snapshot_policy_id>
        </data_disks>
        <image_id>aliyun_2_1903_x64_20G_alibase_20200529.vhd</image_id>
        <instance_charge_type>PostPaid</instance_charge_type>
        <instance_types>ecs.n4.large</instance_types>
        <multi_az_policy>BALANCE</multi_az_policy>
        <on_demand_base_capacity>0</on_demand_base_capacity>
        <on_demand_percentage_above_base_capacity>20</on_demand_percentage_above_base_capacity>
        <spot_instance_pools>5</spot_instance_pools>
        <spot_instance_remedy>false</spot_instance_remedy>
        <compensate_with_on_demand>true</compensate_with_on_demand>
        <period>0</period>
        <period_unit>Month</period_unit>
        <platform>AliyunLinux</platform>
        <ram_policy>KubernetesWorkerRole-021dc54f-929b-437a-8ae0-34c24d3e****</ram_policy>
        <spot_strategy>NoSpot</spot_strategy>
        <spot_price_limit>
            <instance_type>ecs.c6.large</instance_type>
            <price_limit>0.39</price_limit>
        </spot_price_limit>
        <rds_instances>rm-xxx</rds_instances>
        <scaling_group_id>asg-2zeieod8giqmov7z****</scaling_group_id>
        <scaling_policy>release</scaling_policy>
        <security_group_id>sg-2ze60ockeekspl3d****</security_group_id>
        <security_group_ids>sg-2ze60ockeekspl3d****</security_group_ids>
        <system_disk_category>cloud_efficiency</system_disk_category>
        <system_disk_size>120</system_disk_size>
        <tags>
            <key>env</key>
            <value>prod</value>
        </tags>
        <vswitch_ids>vsw-2ze3ds0mdip0hdz8i****</vswitch_ids>
        <login_password>********</login_password>
        <key_pair>pro-nodepool</key_pair>
        <internet_charge_type>PayByBandwidth</internet_charge_type>
        <internet_max_bandwidth_out>10</internet_max_bandwidth_out>
    </scaling_group>
    <status>
        <failed_nodes>0</failed_nodes>
        <healthy_nodes>3</healthy_nodes>
        <initial_nodes>0</initial_nodes>
        <offline_nodes>0</offline_nodes>
        <removing_nodes>0</removing_nodes>
        <serving_nodes>3</serving_nodes>
        <state>active</state>
        <total_nodes>3</total_nodes>
    </status>
    <tee_config>
        <tee_enable>false</tee_enable>
    </tee_config>
    <management>
        <enable>true</enable>
        <auto_repair>true</auto_repair>
        <upgrade_config>
            <auto_upgrade>true</auto_upgrade>
            <surge>5</surge>
            <surge_percentage>50</surge_percentage>
            <max_unavailable>1</max_unavailable>
        </upgrade_config>
    </management>
</DescribeClusterNodePoolDetailResponse>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "auto_scaling" : {
    "eip_bandwidth" : 5,
    "eip_internet_charge_type" : "PayByBandwidth",
    "enable" : true,
    "is_bond_eip" : true,
    "max_instances" : 10,
    "min_instances" : 1,
    "type" : "cpu"
  },
  "kubernetes_config" : {
    "cms_enabled" : true,
    "cpu_policy" : "none",
    "labels" : [ {
      "key" : "env",
      "value" : "prod"
    } ],
    "runtime" : "docker",
    "runtime_version" : "19.03.5",
    "taints" : [ {
      "key" : "key",
      "value" : "value",
      "effect" : "NoSchedule"
    } ],
    "user_data" : "IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFDSyEi"
  },
  "nodepool_info" : {
    "created" : "2020-09-27T19:14:09.156823496+08:00",
    "is_default" : true,
    "name" : "default-nodepool",
    "nodepool_id" : "np615c0e0966124216a0412e10afe0****",
    "region_id" : "cn-beijing",
    "resource_group_id" : "rg-acfmyvw3wjmb****",
    "type" : "ess",
    "updated" : "2020-09-27T20:37:46+08:00"
  },
  "scaling_group" : {
    "auto_renew" : false,
    "auto_renew_period" : 1,
    "data_disks" : [ {
      "category" : "cloud_ssd",
      "size" : 40,
      "encrypted" : "true",
      "auto_snapshot_policy_id" : "sp-2zej1nogjvovnz4z****"
    } ],
    "image_id" : "aliyun_2_1903_x64_20G_alibase_20200529.vhd",
    "instance_charge_type" : "PostPaid",
    "instance_types" : [ "ecs.n4.large" ],
    "multi_az_policy" : "BALANCE",
    "on_demand_base_capacity" : 0,
    "on_demand_percentage_above_base_capacity" : 20,
    "spot_instance_pools" : 5,
    "spot_instance_remedy" : false,
    "compensate_with_on_demand" : true,
    "period" : 0,
    "period_unit" : "Month",
    "platform" : "AliyunLinux",
    "ram_policy" : "KubernetesWorkerRole-021dc54f-929b-437a-8ae0-34c24d3e****",
    "spot_strategy" : "NoSpot",
    "spot_price_limit" : [ {
      "instance_type" : "ecs.c6.large",
      "price_limit" : "0.39"
    } ],
    "rds_instances" : [ "rm-xxx" ],
    "scaling_group_id" : "asg-2zeieod8giqmov7z****",
    "scaling_policy" : "release",
    "security_group_id" : "sg-2ze60ockeekspl3d****",
    "security_group_ids" : [ "sg-2ze60ockeekspl3d****" ],
    "system_disk_category" : "cloud_efficiency",
    "system_disk_size" : 120,
    "tags" : [ {
      "key" : "env",
      "value" : "prod"
    } ],
    "vswitch_ids" : [ "vsw-2ze3ds0mdip0hdz8i****" ],
    "login_password" : "********",
    "key_pair" : "pro-nodepool",
    "internet_charge_type" : "PayByBandwidth",
    "internet_max_bandwidth_out" : 10
  },
  "status" : {
    "failed_nodes" : 0,
    "healthy_nodes" : 3,
    "initial_nodes" : 0,
    "offline_nodes" : 0,
    "removing_nodes" : 0,
    "serving_nodes" : 3,
    "state" : "active",
    "total_nodes" : 3
  },
  "tee_config" : {
    "tee_enable" : false
  },
  "management" : {
    "enable" : true,
    "auto_repair" : true,
    "upgrade_config" : {
      "auto_upgrade" : true,
      "surge" : 5,
      "surge_percentage" : 50,
      "max_unavailable" : 1
    }
  }
}

Error codes

For a list of error codes, visit the API Error Center.