文档首页/ 云容器引擎 CCE/ API参考（吉隆坡区域）/ API/ 集群管理/ 变更集群规格
更新时间：2024-10-22 GMT+08:00
查看PDF
分享

变更集群规格

功能介绍

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

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

cluster_id

是

String

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

消息体的类型（格式）

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节点）
说明：

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

  • s1：单控制节点的集群，控制节点数为1。单控制节点故障后，集群将不可用，但已运行工作负载不受影响。
  • s2：三控制节点的集群，即高可用集群，控制节点数为3。当某个控制节点故障时，集群仍然可用。
  • small：表示集群支持管理的最大节点规模为50节点。
  • medium：表示集群支持管理的最大节点规模为200节点。
  • large：表示集群支持管理的最大节点规模为1000节点。
  • xlarge：表示集群支持管理的最大节点规模为2000节点。

extendParam

否

extendParam object

-
表4 extendParam

参数

是否必选

参数类型

描述

decMasterFlavor

否

String

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

响应参数

状态码： 201

表5 响应Body参数

参数

参数类型

描述

jobID

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

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

错误码

请参见错误码。

父主题： 集群管理