更新时间:2025-05-16 GMT+08:00

伸缩节点池

功能介绍

该API用于伸缩指定的节点池

集群管理的URL格式为:https://Endpoint/uri。其中uri为资源路径,也即API访问的路径

URI

POST /api/v3/projects/{project_id}/clusters/{cluster_id}/nodepools/{nodepool_id}/operation/scale

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID,获取方式请参见如何获取接口URI中参数。

cluster_id

是

String

集群ID,获取方式请参见如何获取接口URI中参数。

nodepool_id

是

String

节点池ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

消息体的类型(格式)

X-Auth-Token

是

String

调用接口的认证方式分为Token和AK/SK两种,如果您使用的Token方式,此参数为必填,请填写Token的值,获取方式请参见获取token。

表3 请求Body参数

参数

是否必选

参数类型

描述

kind

是

String

API类型,固定值“NodePool”。

apiVersion

是

String

API版本,固定值“v3”。

spec

是

ScaleNodePoolSpec object

伸缩节点池请求详细参数

表4 ScaleNodePoolSpec

参数

是否必选

参数类型

描述

desiredNodeCount

是

Integer

节点池期望节点数

scaleGroups

是

Array of strings

扩缩容的节点池,只能填一个伸缩组,如果要伸缩默认伸缩组填default

options

否

ScaleNodePoolOptions object

节点池伸缩选项配置

表5 ScaleNodePoolOptions

参数

是否必选

参数类型

描述

scalableChecking

否

String

扩容状态检查策略: instant(同步检查), async(异步检查)。默认同步检查instant

billingConfigOverride

否

ScaleUpBillingConfigOverride object

节点池扩容时覆盖节点的默认计费模式配置

表6 ScaleUpBillingConfigOverride

参数

是否必选

参数类型

描述

billingMode

是

Integer

节点计费类型,0(按需)

响应参数

无

请求示例

  • 扩容节点池默认伸缩组(按需)
    {
      "kind" : "NodePool",
      "apiVersion" : "v3",
      "spec" : {
        "desiredNodeCount" : 1,
        "scaleGroups" : [ "default" ]
      }
    }

响应示例

无

状态码

状态码

描述

202

表示节点池伸缩已经被接受,节点池将根据伸缩后的节点池期望节点数增加或者删除节点池中的节点

错误码

请参见错误码。