更新时间:2025-12-08 GMT+08:00

变更集群规格

功能介绍

该API用于变更一个指定集群的规格。

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

调用方法

请参见如何调用API

URI

POST /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/resize

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

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

约束限制:

不涉及

取值范围:

账号的项目ID

默认取值:

不涉及

cluster_id

String

参数解释:

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

约束限制:

不涉及

取值范围:

集群ID

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释:

消息体的类型(格式)

约束限制:

GET方法不做校验

取值范围:

  • application/json

  • application/json;charset=utf-8

  • application/x-pem-file

  • multipart/form-data(注:存在FormData参数时使用)

默认取值:

不涉及

X-Auth-Token

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

flavorResize

String

参数解释

要变更的目标规格。仅支持变更集群最大节点规模,不支持变更控制节点数,且不支持降低集群规格。例如原集群规格为cce.s2.medium,仅支持变更至cce.s2.large及以上规格,不支持变更至cce.s2.small或cce.s1.medium。

约束限制

不涉及

取值范围

  • cce.s1.small: 小规模单控制节点CCE集群(最大50节点)

  • cce.s1.medium: 中等规模单控制节点CCE集群(最大200节点)

  • cce.s2.small: 小规模三控制节点CCE集群(最大50节点)

  • cce.s2.medium: 中等规模三控制节点CCE集群(最大200节点)

  • cce.s2.large: 大规模三控制节点CCE集群(最大1000节点)

  • cce.s2.xlarge: 超大规模三控制节点CCE集群(最大2000节点)

  • cce.s3.small: 小规模五控制节点CCE集群(最大50节点)

  • cce.s3.medium: 中等规模五控制节点CCE集群(最大200节点)

  • cce.s3.large: 大规模五控制节点CCE集群(最大1000节点)

  • cce.s3.xlarge: 超大规模五控制节点CCE集群(最大2000节点)

默认取值

不涉及

说明:

关于规格参数中的字段说明如下:

  • s1:单控制节点的集群,控制节点数为1。单控制节点故障后,集群将不可用,但已运行工作负载不受影响。

  • s2:三控制节点的集群,即高可用集群,控制节点数为3。当某个控制节点故障时,集群仍然可用。

  • s3:五控制节点的集群,即超高可用集群,控制节点数为5。当某2个控制节点故障时,集群仍然可用。

  • small:表示集群支持管理的最大节点规模为50节点。

  • medium:表示集群支持管理的最大节点规模为200节点。

  • large:表示集群支持管理的最大节点规模为1000节点。

  • xlarge:表示集群支持管理的最大节点规模为2000节点。

skippedTasks

Array of strings

参数解释

该参数用于控制集群规格变更时跳过部分任务。

约束限制

取值范围

  • IngressChecker: 集群规格变更时跳过Ingress与ELB配置一致性检查

说明:
  • 跳过Ingress与ELB配置一致性检查可能导致业务中断,请谨慎操作!

  • 集群不可用或者过载时,必须跳过Ingress与ELB配置一致性检查,否则会导致集群规格变更失败。

默认取值

集群不可用时默认包含IngressChecker

extendParam

extendParam object

参数解释

变更集群规格扩展字段

约束限制

不涉及

表4 extendParam

参数

是否必选

参数类型

描述

decMasterFlavor

String

参数解释

专属云CCE集群可指定控制节点的规格

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

响应参数

状态码:201

表5 响应Body参数

参数

参数类型

描述

jobID

String

参数解释

任务ID

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

orderID

String

参数解释

包周期集群变更规格订单ID

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

请求示例

  • 变更按需集群规格

    POST /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/resize
    
    {
      "flavorResize" : "cce.s1.medium"
    }

响应示例

状态码:201

表示按需集群规格变更作业下发成功

{
  "jobID" : "13b8d958-8fcf-11ed-aef3-0255ac1001bd"
}

状态码

状态码

描述

201

表示按需集群规格变更作业下发成功

错误码

请参见错误码