文档首页/ 云容器引擎 CCE/ API参考/ API/ 集群管理/ 变更集群规格 - ResizeClusterFlavor
更新时间:2026-09-07 GMT+08:00

变更集群规格 - ResizeClusterFlavor

功能介绍

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

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

  • 使用限制请参考变更集群规格。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    cce:cluster:resize

    Write

    cluster *

    • g:EnterpriseProjectId

    • g:ResourceTag/<tag-key>

    -

    -

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

参数解释:

消息体的类型(格式),默认为application/json,有其他取值时会在具体接口中专门说明。

约束限制:

GET方法不做校验

取值范围:

不涉及

默认取值:

不涉及

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。

约束限制:

VPC 网络模型建议集群规模为 1000 节点及以下。集群本身规模受 VPC 路由表配额上限限制,若扩容规格至cce.s2.xlarge,可能出现实际节点规模无法达到目标规模的情况。

取值范围:

  • 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节点)

默认取值:

不涉及

说明:
关于规格参数中的字段说明如下:
  • s1:单控制节点的集群,控制节点数为1。单控制节点故障后,集群将不可用,但已运行工作负载不受影响。

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

  • dec:表示专属云的CCE集群规格。例如cce.dec.s1.small表示小规模单控制节点的专属云CCE集群(最大50节点)。

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

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

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

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

skippedTasks

否

Array of strings

参数解释:

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

约束限制:

无

取值范围:

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

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

  • 集群不可用或者过载时,必须跳过Ingress与ELB配置一致性检查,否则会导致集群规格变更失败。请确保变更集群规格前已按 ELB Ingress与ELB配置不一致如何处理? 指南解决一致性问题。

默认取值:

集群不可用时默认包含IngressChecker

extendParam

否

extendParam object

参数解释:

变更集群规格扩展字段

约束限制:

不涉及

表4 extendParam

参数

是否必选

参数类型

描述

decMasterFlavor

否

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

isAutoPay

否

String

参数解释:

是否自动扣款

约束限制:

不涉及

取值范围:

  • “true”:自动扣款

  • “false”:不自动扣款

说明:
包周期集群时生效,不填写此参数时默认不会自动扣款。

默认取值:

不涉及

响应参数

状态码:201

表5 响应Body参数

参数

参数类型

描述

jobID

String

参数解释:

任务ID

取值范围:

不涉及

orderID

String

参数解释:

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

取值范围:

不涉及

请求示例

  • 变更包周期集群规格(自动付费)

    POST /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/resize
    
    {
      "flavorResize" : "cce.s1.medium",
      "extendParam" : {
        "isAutoPay" : "true"
      }
    }
  • 变更按需集群规格

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

响应示例

状态码:201

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

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

状态码

状态码

描述

201

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

错误码

请参见错误码。