All Products
Search
Document Center

ENS:ModifyClusterNodePool

Last Updated:Jan 21, 2026

You can call the ModifyClusterNodePool operation to modify node configurations in a cluster node pool, such as kubelet and node rotation configurations. This operation modifies configurations in batches and restarts the kubelet, which may affect node and workload operations. Perform this operation during off-peak hours.

Operation description

  • Each user is limited to 10 calls per second.

  • Modifying a node pool is an asynchronous operation. After you call the API, the operation takes 10 to 20 minutes to complete. During this time, you can call the DescribeClustersV1 operation to check the cluster status.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

ClusterId

string

Yes

The cluster ID.

eck-xxxxxxxx

NodepoolInfo

object

Yes

The information about the node pool.

NodepoolId

string

Yes

The node pool ID.

np68mi5y1dd748ky37ojo2kqdrz

ScalingGroup

object

No

The configuration of the scaling group.

Password

string

No

The password for the instance. Specify either this parameter or KeyPairName.

@AN5Ejx1YyzzK

KeyPairName

string

No

The key pair for the instance. Specify either this parameter or Password.

tf-testAcc

VswitchIds

array

No

The IDs of the vSwitches that the instances use.

string

No

The ID of the vSwitch where the cluster nodes are located. The ENS region of the vSwitch must be the same as the ENS region of the cluster.

vsw-58eu2p6v64qw8ihhit1wz7wgv

InstanceChargeType

string

No

The billing method of the instance.

PostPaid

InstanceTypes

array

No

The instance types.

string

No

The instance type.

ens.sn1.small

SystemDiskCategory

string

No

The type of the system disk.

cloud_efficiency

SystemDiskSize

integer

No

The size of the system disk.

80

ImageId

string

No

The ID of the instance image.

m-68bysm5a8gkm7oik7ngacf0in

DataDisks

array<object>

No

The information about the data disks.

object

No

The information about the data disk.

Category

string

No

The type of the data disk.

cloud_efficiency

Size

integer

No

The size of the data disk.

40

KubernetesConfig

object

No

The Kubernetes configuration.

PreUserData

string

No

The script to run on the instance after it is created but before it joins the cluster. The content must be Base64-encoded.

ZWNobyBvawo=

UserData

string

No

The script to run on the instance after it is created and has joined the cluster. The content must be Base64-encoded.

ZWNobyBvawo=

Response elements

Element

Type

Description

Example

object

The schema of the response body.

RequestId

string

The request ID.

C0003E8B-B930-4F59-ADC0-0E209A9012A8

Examples

Success response

JSON format

{
  "RequestId": "C0003E8B-B930-4F59-ADC0-0E209A9012A8"
}

Error codes

HTTP status code

Error code

Error message

Description

400 BadRequest Request param error. Request parameter error

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.