文档中心

容器服务

请输入

节点池管理

ScaleNodePool - 扩容节点池

扩容指定的节点池。

说明

该 OpenAPI 接口仅能够在指定的节点池中扩容节点，不支持缩容节点。如有节点缩容需求，建议使用 UpdateNodePoolConfig 或 DeleteNodes 接口。

请求说明

VKE 已在全球多个地域部署服务，旨在为您提供更稳定、低延迟的访问体验。您可以通过查阅服务地址文档，根据业务所在地域，选择最合适的接入点。

请求方式：POST

请求地址：https://vke.cn-beijing.volcengineapi.com?Action=ScaleNodePool&Version=2022-05-12

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

调用该 API 时的请求参数如下，除此之外还需传入公共请求参数。公共请求参数说明，请参见公共参数。

参数	类型	是否必选	示例值	描述
Action	String	是	ScaleNodePool	接口名称。当前 API 的名称为 ScaleNodePool。
Version	String	是	2022-05-12	接口版本。当前 API 的版本为 2022-05-12。
ClusterId	String	是	cc5silu*******	节点池所在集群的 ID。可以调用 ListClusters 接口，获取集群 ID。注意集群必须处于{Running,[Ok]}或{Updating,[Progressing]}状态。可调用 ListClusters 接口获取集群当前的状态。
Id	String	是	pc51i0*******	节点池 ID。可以调用 ListNodePools 接口，获取节点池 ID。注意节点池必须处于{Running,[*]}或{Scaling,[Progressing]}状态。可调用 ListNodePools 接口获取节点池当前的状态。
Count	Integer	是	2	扩容节点数量，取值为大于 0 的整数。说明该参数的取值上限与节点池的期望节点数配置相关：节点池的期望节点数（DesiredReplicas）+ 扩容节点数（Count）总和不能超过节点池上限值 2000。节点池开启弹性伸缩时，扩容后的节点总数不能超过MaxReplicas 参数配置。 DesiredReplicas和MaxReplicas的配置方式，请参见 CreateNodePool。
ClientToken	String	否	BC028527-33***	用于保证请求幂等性的字符串。该字符串由调用方传入，需保证不同请求之间唯一。ClientToken 对大小写敏感，且最大值不超过 64 个 ASCII 字符。

请求示例

返回参数

本接口无专有返回参数，公共返回参数请参见返回结果。

返回示例

错误码

本接口错误码如下表所示，公共错误码请参见公共错误码。

HTTP 状态码	错误码	错误信息	说明
400	OperationDenied.ClusterStatus	The action is forbidden due to cluster status {{statusPhase}} and {{statusConditions}}.	指定集群的当前状态不支持该操作。请确认该接口依赖的集群状态后重试。
400	OperationDenied.NodePoolStatus	The action is forbidden on node pool {{nodePoolId}} due to node pool status {{statusPhase}} and {{statusConditions}}.	指定节点池的当前状态不支持该操作。请确认该接口依赖的节点池状态后重试。
400	Mismatch.Replicas	The specified DesiredReplicas, MinReplicas and MaxReplicas are mismatched.	指定节点池的最小节点数、最大节点数、期望节点数逻辑不匹配。请确认参数后重试。
400	QuotaExceeded.Node	The number of nodes in the cluster has reached the limit.	您当前集群所要创建的节点数量超出系统限额。您可以选择其他地域，也可以提交工单申请提高配额。
400	LimitExceeded.NodeInCluster	The number of nodes exceeds the cluster defined pods config limit.	Flannel 容器网络类型下，节点池设置的期望节点数超出了集群支持的最大节点数。容器服务各资源限制，请参见使用限制。支持的最大节点数取决于 PodsConfig.FlannelConfig.PodCidrs 和 MaxPodsPerNode。集群创建完成后不支持修改，请合理规划集群设置。
400	UpdateNotAllowed.{{parameter}}	The update to the specified parameter {{parameter}} is not allowed due to {{resourceType}}.	指定资源类型对象的部分属性不能更新。
400	QuotaExceeded.{{ResourceType}}	The quota of {{ResourceType}} has reached the limit.	指定资源的配额达到上限，如 EIP、EBS 等。请提升相关资源配额，或删除无用资源，预留出配额后重试。
400	Insufficient.Balance	Your account has run out of balance.	当前账户余额不足。请充值账户后重试。

最近更新时间：2026.07.03 16:44:04

这个页面对您有帮助吗？

有用

无用