更新时间:2024-10-22 GMT+08:00

变更集群规格

功能介绍

该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

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

错误码

请参见错误码