扩容指定的节点池。

说明

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

## 请求说明 VKE 已在全球多个地域部署服务，旨在为您提供更稳定、低延迟的访问体验。您可以通过查阅 [服务地址](https://www.volcengine.com/docs/6460/1899855) 文档，根据业务所在地域，选择最合适的接入点。 * 请求方式：POST * 请求地址：https://vke.cn\-beijing.volcengineapi.com?Action=ScaleNodePool&Version=2022\-05\-12 ## 调试 [去调试](https://api.volcengine.com/api-explorer/debug?action=ScaleNodePool&serviceCode=vke&version=2022-05-12&groupName=) ## 请求参数调用该 API 时的请求参数如下，除此之外还需传入公共请求参数。公共请求参数说明，请参见 [公共参数](https://www.volcengine.com/docs/6460/70904)。 |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |ScaleNodePool |接口名称。当前 API 的名称为 `ScaleNodePool`。 | |Version |String |是 |2022\-05\-12 |接口版本。当前 API 的版本为 `2022-05-12`。 | |ClusterId |String |是 |cc5silu\*\*\*\*\*\*\* |节点池所在集群的 ID。

可以调用 [ListClusters](https://www.volcengine.com/docs/6460/115190) 接口，获取集群 ID。

注意

集群必须处于{Running,[Ok]}或{Updating,[Progressing]}状态。可调用 ListClusters接口获取集群当前的状态。

| |Id |String |是 |pc51i0\*\*\*\*\*\*\* |节点池 ID。

可以调用 [ListNodePools](https://www.volcengine.com/docs/6460/115197) 接口，获取节点池 ID。

注意

节点池必须处于{Running,[*]}或{Scaling,[Progressing]}状态。可调用 ListNodePools接口获取节点池当前的状态。

说明

该参数的取值上限与节点池的期望节点数配置相关：

节点池的期望节点数（DesiredReplicas）+ 扩容节点数（Count）总和不能超过节点池上限值 2000。

节点池开启弹性伸缩时，扩容后的节点总数不能超过MaxReplicas 参数配置。

DesiredReplicas和MaxReplicas的配置方式，请参见 CreateNodePool。

| |ClientToken |String |否 |BC028527\-33\*\*\* |用于保证请求幂等性的字符串。该字符串由调用方传入，需保证不同请求之间唯一。ClientToken 对大小写敏感，且最大值不超过 64 个 ASCII 字符。 | ## 请求示例 ```JSON POST https://vke.cn-beijing.volcengineapi.com?Action=ScaleNodePool&Version=2022-05-12 Content-Type: application/json { "ClusterId": "cc5silu*******", "Id": "pc51i0*******", "Count": 2, "ClientToken": "BC028527-33***" } ``` ## 返回参数本接口无专有返回参数，公共返回参数请参见 [返回结果](https://www.volcengine.com/docs/6460/79674)。 ## 返回示例 ```JSON { "ResponseMetadata": { "RequestId": "20230604110420****100232280022D31", "Action": "ScaleNodePool", "Version": "2022-05-12", "Service": "vke", "Region": "cn-beijing" } } ``` ## 错误码本接口错误码如下表所示，公共错误码请参见 [公共错误码](https://www.volcengine.com/docs/6460/118978)。 |**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. |您当前集群所要创建的节点数量超出系统限额。您可以选择其他地域，也可以 [提交工单](https://console.volcengine.com/ticket/createTicketV2/?step=2&Service=vke)申请提高配额。 | |400 |LimitExceeded.NodeInCluster |The number of nodes exceeds the cluster defined pods config limit. |Flannel 容器网络类型下，节点池设置的期望节点数超出了集群支持的最大节点数。容器服务各资源限制，请参见 [使用限制](https://www.volcengine.com/docs/6460/79642)。

支持的最大节点数取决于 **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. |当前账户余额不足。请充值账户后重试。 |