All Products
Search
Document Center

Container Service for Kubernetes:DescribeClusterNodePools

Last Updated:Dec 03, 2024
This topic is generated by a machine translation engine without any human intervention. ALIBABA CLOUD DOES NOT GUARANTEE THE ACCURACY OF MACHINE TRANSLATED CONTENT. To request a human-translated version of this topic or provide feedback on this translation, please include it in the feedback form.

Queries the information about all node pools in a cluster.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • The required resource types are displayed in bold characters.
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
cs:DescribeClusterNodePoolsget
*Cluster
acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
    none
none

Request syntax

GET /clusters/{ClusterId}/nodepools HTTP/1.1

Request parameters

ParameterTypeRequiredDescriptionExample
ClusterIdstringYes

The ID of the cluster that you want to query.

cc0f87de0b8fb403f86e10e204f83****
NodepoolNamestringNo

Node pool name.

nodepool-test

Response parameters

ParameterTypeDescriptionExample
object

The details of the node pools.

nodepoolsarray<object>

The node pools.

nodepoolsobject

The information about the node pool.

nodepool_infoobject

The information about the node pool.

nodepool_idstring

The node pool ID.

np615c0e0966124216a0412e10afe0****
namestring

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 (-).

default-nodepool
typestring

The type of node pool. Valid values:

  • edge: edge node pool.
  • ess: node pool in the cloud.
ess
is_defaultboolean

Specifies whether the node pool is a default node pool. A Container Service for Kubernetes (ACK) cluster generally has only one default node pool. Valid values:

  • true
  • false:
true
resource_group_idstring

The resource group ID.

rg-acfmyvw3wjm****
region_idstring

The region ID.

cn-beijing
createdstring

The time when the node pool was created.

2020-09-27T19:14:09.156823496+08:00
updatedstring

The time when the node pool was last updated.

2020-09-27T20:37:46+08:00
statusobject

The status details of the node pool.

statestring

The status of the node pool. Valid values:

  • active: The node pool is active.
  • scaling: The node pool is being scaled.
  • removing: The nodes are being removed from the node pool.
  • deleting: The node pool is being deleted.
  • updating: The node pool is being updated.
active
healthy_nodeslong

The number of healthy nodes.

3
initial_nodeslong

The number of nodes that are being created.

0
failed_nodeslong

The number of failed nodes.

0
offline_nodeslong

The number of offline nodes.

0
removing_nodeslong

The number of nodes that are being removed.

0
serving_nodeslong

The number of running nodes.

3
total_nodeslong

The total number of nodes in the node pool.

3
auto_scalingobject

The configurations of auto scaling.

enableboolean

Specifies whether to enable auto scaling. Valid values:

  • true
  • false: If you set this parameter to false, other parameters in auto_scaling do not take effect.
true
typestring

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.
cpu
max_instanceslong

The maximum number of Elastic Compute Service (ECS) instances that can be created in the node pool.

10
min_instanceslong

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

2
eip_internet_charge_typestring

The billing method of the EIP. Valid values:

  • PayByBandwidth: pay-by-bandwidth.
  • PayByTraffic: pay-by-data-transfer.
PayByBandwidth
is_bond_eipboolean

Specifies whether to associate an EIP with the node pool. Valid values:

  • true
  • false
true
eip_bandwidthlong

The maximum bandwidth of the elastic IP address (EIP).

5
managementobject

The configurations of managed node pools. Managed node pools are available only in professional managed Kubernetes clusters.

enableboolean

Specifies whether to enable the managed node pool feature. Valid values:

  • true
  • false: If you set this parameter to false, other parameters of management do not take effect.
true
auto_repairboolean

Specifies whether to enable auto repair. This parameter takes effect only if enable is set to true. Valid values:

  • true
  • false
true
auto_repair_policyobject

The auto node repair policy.

restart_nodeboolean

Specifies whether to allow node restart.

true
auto_vul_fixboolean

Specifies whether to enable auto Common Vulnerabilities and Exposures (CVE) patching.

true
auto_vul_fix_policyobject

The auto CVE patching policy.

restart_nodeboolean

Specifies whether to allow node restart.

true
vul_levelstring

The severity level of CVEs that can be automatically patched. Multiple severity levels are separated by commas (,).

asap,nntf
auto_upgradeboolean

Specifies whether to enable auto update.

true
auto_upgrade_policyobject

The auto update policy.

auto_upgrade_kubeletboolean

Specifies whether to allow auto update of the kubelet.

true
upgrade_configobject

The configurations of auto update. The configurations take effect only if enable is set to true.

auto_upgradeboolean

Specifies whether to enable auto update. Valid values:

  • true
  • false
true
surgelong

The number of additional nodes.

5
surge_percentagelong

The percentage of additional nodes to the total nodes in the node pool. You must specify this parameter or the surge parameter.

The number of additional nodes = The percentage of additional nodes × The number of nodes in the node pool. For example, if the percentage of additional nodes is 50% and the number of nodes in the node pool is 6, the number of additional nodes is 3.

50
max_unavailablelong

The maximum number of unavailable nodes. Valid values: 1 to 1000.

Default value: 1

1
scaling_groupobject

The configurations of the scaling group.

scaling_group_idstring

The scaling group ID.

asg-2ze8n5qw4atggut8****
vswitch_idsarray

The vSwitch IDs. You can specify 1 to 20 vSwitches.

Note To ensure high availability, we recommend that you select vSwitches in different zones.
vswitch_idsstring

The vSwitch ID.

vsw-2ze3ds0mdip0hdz8i****
instance_typesarray

The list of instance types. You can select multiple instance types. When the system needs to create a node, it starts from the first instance type until the node is created. The instance type that is used to create the node varies based on the inventory.

instance_typesstring

The instance types of the nodes in the node pool.

ecs.n4.large
instance_charge_typestring

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

  • PrePaid: subscription.
  • PostPaid: pay-as-you-go.
PostPaid
periodlong

The subscription duration of the nodes in the node pool. This parameter takes effect and is required if you set instance_charge_type to PrePaid.

If period_unit is set to Month, the valid values of period are 1, 2, 3, 6, 12, 24, 36, 48, and 60.

1
period_unitstring

The billing cycle of the nodes in the node pool. This parameter takes effect only ifinstance_charge_type is set to PrePaid.

Valid value: Month, which indicates that the subscription duration is measured in months.

Month
auto_renewboolean

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

  • true
  • false
false
auto_renew_periodlong

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

If you set period_unit to Month, the valid values of this parameter are 1, 2, 3, 6, and 12.

0
spot_strategystring

The bidding policy of preemptible instances. Valid values:

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

For more information, see Create a preemptible elastic container instance.

NoSpot
spot_price_limitarray<object>

The bid configurations of preemptible instances.

spot_price_limitobject
instance_typestring

The instance type of preemptible instances.

ecs.c6.large
price_limitstring

The price cap for a single preemptible instance.

Unit: USD/hour.

0.39
image_typestring

The type of the operating system image.

AliyunLinux
image_idstring

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

aliyun_2_1903_x64_20G_alibase_20200529.vhd
system_disk_categorystring

The type of system disk. Valid values:

  • cloud_efficiency: ultra disk
  • cloud_ssd: SSD
cloud_efficiency
system_disk_categoriesarray

The types of system disks. The system attempts to create system disks of a disk type with a lower priority if the disk type with a higher priority is unavailable. Valid values: Valid values: cloud (basic disk), cloud_efficiency (ultra disk), cloud_ssd (standard SSD), cloud_essd (Enterprise SSD).

system_disk_categoriesstring

The system disk type.

ESSD
system_disk_sizelong

The size of the system disk. Unit: GiB.

Valid values: 20 to 500.

120
system_disk_performance_levelstring

The performance level (PL) of the system disk. This parameter takes effect only for an ESSD.

PL1
system_disk_encryptedboolean

Specifies whether to encrypt the system disk. Valid values:

  • true
  • false
false
system_disk_kms_key_idstring

The ID of the Key Management Service (KMS) key that is used to encrypt the system disk.

0e478b7a-4262-4802-b8cb-00d3fb40****
system_disk_encrypt_algorithmstring

The encryption algorithm that is used to encrypt the system disk. The value is aes-256.

aes-256
system_disk_bursting_enabledboolean

Specifies whether to enable Burst for the system disk when the disk type is cloud_auto.

true
system_disk_provisioned_iopslong

The predefined read and write IOPS of the system disk when the disk type is cloud_auto.

1000
data_disksarray

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

data_disksdata_disk

The configurations of the node data disks.

security_group_idsarray

The IDs of security groups for the node pool.

security_group_idsstring

The IDs of security groups for the node pool.

sg-2ze1iuk12m2sb4c4****
key_pairstring

The name of the key pair. You must specify this parameter or the login_password parameter.

You must specify the key_pair parameter if the node pool is a managed node pool.

pro-nodepool
login_passwordstring

The password for SSH logon. You must specify 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.

The returned password is encrypted to ensure security.

******
login_as_non_rootboolean

Specifies whether a non-root user can log on to the ECS instance added to the node pool.

true
cis_enableddeprecatedboolean

Specifies whether to enable Center for Internet Security (CIS) reinforcement. CIS reinforcement can be enabled only if Alibaba Cloud Linux 2 or Alibaba Cloud Linux 3 is installed on nodes.

false
soc_enabledboolean

Specifies whether to enable reinforcement based on classified protection. You can enable reinforcement based on classified protection only if Alibaba Cloud Linux 2 or Alibaba Cloud Linux 3 is installed on nodes. Alibaba Cloud provides standards for baseline check and a scanner to ensure the compliance of Alibaba Cloud Linux 2 and Alibaba Cloud Linux 3 images with the level 3 standards of classified protection.

false
security_hardening_osboolean

Alibaba Cloud OS security hardening. Values:

  • true: Enable Alibaba Cloud OS security hardening. - false: Do not enable Alibaba Cloud OS security hardening. Default value: false.
false
internet_charge_typestring

The billing method of the public IP address.

PayByBandwidth
internet_max_bandwidth_outlong

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

10
tagsarray

The labels that you want to add only to Elastic Compute Service (ECS) instances.

The tag key must be unique and cannot exceed 128 characters in length. The tag key and value must not start with aliyun or acs: or contain https:// or http://.

tagstag

The labels that you want to add to the nodes.

desired_sizelong

The expected number of nodes in the node pool.

2
multi_az_policystring

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

  • PRIORITY: ECS instances are created based on the VSwitchIds.N parameter. If Auto Scaling fails to create an ECS instance in the zone of the vSwitch that has the highest priority, Auto Scaling attempts to create the ECS instance in the zone of the vSwitch that has a lower priority.

  • COST_OPTIMIZED: ECS instances are created based on the vCPU unit price in ascending order. Preemptible instances are preferably created when preemptible instance types are specified in the scaling configuration. You can specify CompensateWithOnDemand to specify whether to automatically create pay-as-you-go instances if preemptible instances cannot be created due to insufficient resources.

    **

    Note COST_OPTIMIZED takes effect only if 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 the distribution of ECS instances across zones is not balanced due to reasons such as insufficient inventory, you can call the RebalanceInstances operation to evenly distribute the ECS instances across zones. For more information, see RebalanceInstances .

COST_OPTIMIZED
scaling_policystring

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 that are attached to local disks.
release
on_demand_base_capacitylong

The minimum number of pay-as-you-go instances that must be kept in the scaling group. Valid values: 0 to 1000. If the number of pay-as-you-go instances is smaller than the value of this parameter, Auto Scaling preferably creates pay-as-you-go instances

0
on_demand_percentage_above_base_capacitylong

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.

20
spot_instance_poolslong

The number of instance types that are available for creating preemptible instances. Auto Scaling creates preemptible instances of multiple instance types that are available at the lowest cost. Valid values: 1 to 10.

5
spot_instance_remedyboolean

Specifies whether to enable the supplementation of preemptible instances. If the supplementation of preemptible instances is enabled, 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
  • false
false
compensate_with_on_demandboolean

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

  • true
  • false
true
deploymentset_idstring

The deployment set ID.

ds-bp1d19mmbsv3jf6xxxxx
rds_instancesarray

The ApsaraDB RDS instances. If you specify the list of ApsaraDB RDS instances, ECS instances in the cluster are automatically added to the whitelist of the ApsaraDB RDS instances.

rds_instancesstring

The ApsaraDB RDS instance.

rm-xxx
private_pool_optionsobject

The configurations of the private node pool.

idstring

The private pool ID, which is the same as the ID of the elasticity assurance or capacity reservation for which the private pool is generated.

eap-bp67acfmxazb4****
match_criteriastring

The type of the private node pool. This parameter specifies the type of the private node pool that is used to create instances. A private node pool is generated when an elasticity assurance or a capacity reservation service takes effect. The system selects a private node pool to launch instances. Valid values:

  • Open: uses open private pool. The system selects an open private node pool to launch instances. If no matching open private node pool is available, the resources in the public node pool are used.
  • Target: uses the specified private node pool. The system uses the resources of the specified private node pool to launch instances. If the specified private node pool is unavailable, instances cannot be launched.
  • None: No private node pool is used. The resources of private node pools are not used to launch instances.
Open
security_group_idstring

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 the security_group_ids parameter is returned.

sg-2ze1iuk12m2sb4c4****
platformstring

The operating system distribution. Valid values:

  • CentOS
  • AliyunLinux
  • Windows
  • WindowsCore
AliyunLinux
ram_policystring

This field is deprecated and replaced by the ram_role_name parameter.

KubernetesWorkerRole-021dc54f-929b-437a-8ae0-34c24d3e****
instance_patternsarray

The attributes of an instance.

instance_patterninstance_patterns

The attributes of an instance.

ram_role_namestring

Worker RAM role name.

KubernetesWorkerRole-4a4fa089-80c1-48a5-b3c6-9349311f****
node_configobject

The configurations of nodes.

kubelet_configurationkubelet_config

The configurations of the kubelet.

kubernetes_configobject

The configurations of the cluster.

labelsarray

The labels that are added to the nodes in the cluster. You must add labels based on the following rules:

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

The configurations of the labels.

taintsarray

The taints of the nodes in the node pool. Taints can be used together with tolerations to prevent pods from being scheduled to specific nodes. For more information, see taint-and-toleration.

taintstaint

The taint.

runtimestring

The name of the container runtime.

docker
runtime_versionstring

The version of the container runtime.

19.03.5
cpu_policystring

The CPU management policy of the nodes in the node pool. The following policies are supported if the version of the cluster is Kubernetes 1.12.6 or later:

  • static: allows pods with specific resource characteristics on the node to be granted enhanced CPU affinity and exclusivity.
  • none: specifies that the default CPU affinity is used.
none
user_datastring

The user-defined script that is executed after nodes are initialized. For more information, see Generate user-defined data.

IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD****
unschedulableboolean

Specifies whether the nodes are schedulable after a scale-out activity is performed.

true
cms_enabledboolean

Specifies whether to install the CloudMonitor agent on ECS nodes. After the CloudMonitor agent is installed on ECS nodes, you can view the monitoring information about the instances in the CloudMonitor console. We recommend that you install the CloudMonitor agent. Valid values:

  • true
  • false
true
node_name_modestring

The custom node name. A custom node name consists of a prefix, an IP substring, and a suffix.

  • The prefix and suffix can contain multiple parts that are separated by periods (.). Each part can contain lowercase letters, digits, and hyphens (-). A custom node name must start and end with a digit or lowercase letter.
  • The IP substring length specifies the number of digits to be truncated from the end of the node IP address. The IP substring length ranges from 5 to 12.

For example, if the node IP address is 192.168.0.55, the prefix is aliyun.com, the IP substring length is 5, and the suffix is test, the node name is aliyun.com00055test.

customized,test.,5,.com
pre_user_datastring

The user-defined script that is executed before nodes are initialized. For more information, see Generate user-defined data.

IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD
tee_configobject

The configurations of confidential computing.

tee_enableboolean

Specifies whether to enable confidential computing for the cluster. Valid values:

  • true
  • false
false
interconnect_configobject

This parameter is discontinued.

The network configurations of the edge node pool. This parameter takes effect only on edge node pools.

cen_idstring

This parameter is discontinued.

The ID of the Cloud Enterprise Network (CEN) instance that is associated with the enhanced edge node pool.

cen-ey9k9nfhz0f*******
ccn_idstring

This parameter is discontinued.

The ID of the Cloud Connect Network (CCN) instance that is associated with the enhanced edge node pool.

ccn-qm5i0i0q9yi*******
ccn_region_idstring

This parameter is discontinued.

The region in which the CCN instance that is with the enhanced edge node pool resides.

cn-shanghai
bandwidthlong

This parameter is discontinued.

The bandwidth of the enhanced edge node pool. Unit: Mbit/s.

10
improved_periodstring

This parameter is discontinued.

The subscription duration of the enhanced edge node pool. Unit: months.

1
max_nodeslong

The maximum number of nodes that can be created in the edge node pool. The value of this parameter must be greater than or equal to 0. A value of 0 indicates that the number of nodes in the node pool is limited only by the quota of nodes in the cluster. In most cases, this parameter is set to a value larger than 0 for edge node pools. This parameter is set to 0 for node pools whose types are ess or default edge node pools.

10
interconnect_modestring

The network type of the edge node pool. Valid values: basic and dedicated. This parameter takes effect only on edge node pools.

improved

Examples

Sample success responses

JSONformat

{
  "nodepools": [
    {
      "nodepool_info": {
        "nodepool_id": "np615c0e0966124216a0412e10afe0****",
        "name": "default-nodepool",
        "type": "ess",
        "is_default": true,
        "resource_group_id": "rg-acfmyvw3wjm****",
        "region_id": "cn-beijing",
        "created": "2020-09-27T19:14:09.156823496+08:00",
        "updated": "2020-09-27T20:37:46+08:00"
      },
      "status": {
        "state": "active",
        "healthy_nodes": 3,
        "initial_nodes": 0,
        "failed_nodes": 0,
        "offline_nodes": 0,
        "removing_nodes": 0,
        "serving_nodes": 3,
        "total_nodes": 3
      },
      "auto_scaling": {
        "enable": true,
        "type": "cpu",
        "max_instances": 10,
        "min_instances": 2,
        "eip_internet_charge_type": "PayByBandwidth",
        "is_bond_eip": true,
        "eip_bandwidth": 5
      },
      "management": {
        "enable": true,
        "auto_repair": true,
        "auto_repair_policy": {
          "restart_node": true
        },
        "auto_vul_fix": true,
        "auto_vul_fix_policy": {
          "restart_node": true,
          "vul_level": "asap,nntf"
        },
        "auto_upgrade": true,
        "auto_upgrade_policy": {
          "auto_upgrade_kubelet": true
        },
        "upgrade_config": {
          "auto_upgrade": true,
          "surge": 5,
          "surge_percentage": 50,
          "max_unavailable": 1
        }
      },
      "scaling_group": {
        "scaling_group_id": "asg-2ze8n5qw4atggut8****",
        "vswitch_ids": [
          "vsw-2ze3ds0mdip0hdz8i****"
        ],
        "instance_types": [
          "ecs.n4.large"
        ],
        "instance_charge_type": "PostPaid",
        "period": 1,
        "period_unit": "Month",
        "auto_renew": false,
        "auto_renew_period": 0,
        "spot_strategy": "NoSpot",
        "spot_price_limit": [
          {
            "instance_type": "ecs.c6.large",
            "price_limit": "0.39"
          }
        ],
        "image_type": "AliyunLinux",
        "image_id": "aliyun_2_1903_x64_20G_alibase_20200529.vhd",
        "system_disk_category": "cloud_efficiency",
        "system_disk_categories": [
          "ESSD"
        ],
        "system_disk_size": 120,
        "system_disk_performance_level": "PL1",
        "system_disk_encrypted": false,
        "system_disk_kms_key_id": "0e478b7a-4262-4802-b8cb-00d3fb40****",
        "system_disk_encrypt_algorithm": "aes-256",
        "system_disk_bursting_enabled": true,
        "system_disk_provisioned_iops": 1000,
        "data_disks": [
          {
            "category": "cloud_ssd",
            "size": 40,
            "encrypted": "true",
            "kms_key_id": "0e478b7a-4262-4802-b8cb-00d3fb40****",
            "auto_snapshot_policy_id": "sp-2zej1nogjvovnz4z****",
            "performance_level": "PL1",
            "provisioned_iops": 1000,
            "bursting_enabled": true,
            "auto_format": true,
            "file_system": "ext4",
            "mount_target": "/mnt/path1",
            "disk_name": "DataDiskName",
            "device": "/dev/xvdb",
            "snapshot_id": "s-280s7****"
          }
        ],
        "security_group_ids": [
          "sg-2ze1iuk12m2sb4c4****"
        ],
        "key_pair": "pro-nodepool",
        "login_password": "******",
        "login_as_non_root": true,
        "cis_enabled": false,
        "soc_enabled": false,
        "security_hardening_os": false,
        "internet_charge_type": "PayByBandwidth",
        "internet_max_bandwidth_out": 10,
        "tags": [
          {
            "key": "env",
            "value": "prod"
          }
        ],
        "desired_size": 2,
        "multi_az_policy": "COST_OPTIMIZED",
        "scaling_policy": "release",
        "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,
        "deploymentset_id": "ds-bp1d19mmbsv3jf6xxxxx",
        "rds_instances": [
          "rm-xxx"
        ],
        "private_pool_options": {
          "id": "eap-bp67acfmxazb4****",
          "match_criteria": "Open"
        },
        "security_group_id": "sg-2ze1iuk12m2sb4c4****",
        "platform": "AliyunLinux",
        "ram_policy": "KubernetesWorkerRole-021dc54f-929b-437a-8ae0-34c24d3e****",
        "instance_patterns": [
          {
            "core": 4,
            "memory": 8,
            "instance_family_level": "EnterpriseLevel",
            "max_price": 2,
            "architectures": [
              "X86"
            ],
            "burst_performance_option": "Exclude",
            "excluded_instance_types": [
              "ecs.c6.large"
            ]
          }
        ],
        "ram_role_name": "KubernetesWorkerRole-4a4fa089-80c1-48a5-b3c6-9349311f****"
      },
      "node_config": {
        "kubelet_configuration": {
          "registryPullQPS": 5,
          "registryBurst": 10,
          "eventRecordQPS": 5,
          "eventBurst": 10,
          "kubeAPIQPS": 5,
          "kubeAPIBurst": 10,
          "serializeImagePulls": true,
          "cpuManagerPolicy": "none",
          "evictionHard": {
            "test": "test",
            "test2": 1
          },
          "evictionSoft": {
            "test": "test",
            "test2": 1
          },
          "evictionSoftGracePeriod": {
            "test": "test",
            "test2": 1
          },
          "systemReserved": {
            "test": "test",
            "test2": 1
          },
          "kubeReserved": {
            "test": "test",
            "test2": 1
          },
          "readOnlyPort": 0,
          "maxPods": 110,
          "containerLogMaxSize": "10Mi",
          "containerLogMaxFiles": 5,
          "featureGates": {
            "test": "test",
            "test2": 1
          },
          "allowedUnsafeSysctls": [
            "net.core.somaxconn"
          ]
        }
      },
      "kubernetes_config": {
        "labels": [
          {
            "key": "env",
            "value": "prod"
          }
        ],
        "taints": [
          {
            "key": "key",
            "value": "value",
            "effect": "NoSchedule"
          }
        ],
        "runtime": "docker",
        "runtime_version": "19.03.5",
        "cpu_policy": "none",
        "user_data": "IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD****",
        "unschedulable": true,
        "cms_enabled": true,
        "node_name_mode": "customized,test.,5,.com",
        "pre_user_data": "IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD"
      },
      "tee_config": {
        "tee_enable": false
      },
      "interconnect_config": {
        "cen_id": "cen-ey9k9nfhz0f*******",
        "ccn_id": "ccn-qm5i0i0q9yi*******",
        "ccn_region_id": "cn-shanghai",
        "bandwidth": 10,
        "improved_period": "1"
      },
      "max_nodes": 10,
      "interconnect_mode": "improved"
    }
  ]
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2024-09-27The response structure of the API has changedView Change Details
2024-07-09The response structure of the API has changedView Change Details
2024-06-13The response structure of the API has changedView Change Details
2024-06-13The response structure of the API has changedView Change Details
2024-05-07The request parameters of the API has changedView Change Details
2024-04-22The response structure of the API has changedView Change Details
2024-01-19The response structure of the API has changedView Change Details
2023-12-13The response structure of the API has changedView Change Details
2023-10-17The response structure of the API has changedView Change Details
2023-08-23The response structure of the API has changedView Change Details
2020-09-24The response structure of the API has changedView Change Details
2020-09-24The response structure of the API has changedView Change Details