# 变更集群规格 - ResizeClusterFlavor #### 功能介绍 该API用于变更一个指定集群的规格。 ![](https://support.huaweicloud.com/api-cce/public_sys-resources/note_3.0-zh-cn.png) - 集群管理的URL格式为：https://Endpoint/uri。其中uri为资源路径，也即API访问的路径。 - 使用限制请参考[变更集群规格](https://support.huaweicloud.com/usermanual-cce/cce_10_0403.html)。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-cce/cce_02_0099.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cce/cce_02_0395.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | cce:cluster:resize | Write | cluster \* | - g:EnterpriseProjectId - g:ResourceTag/\ | - | - | #### URI POST /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/resize 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目ID，获取方式请参见[如何获取接口URI中参数](https://support.huaweicloud.com/api-cce/cce_02_0271.html)。 **约束限制：** 不涉及 **取值范围：** 账号的项目ID **默认取值：** 不涉及 | | cluster_id | 是 | String | **参数解释：** 集群ID，获取方式请参见[如何获取接口URI中参数](https://support.huaweicloud.com/api-cce/cce_02_0271.html)。 **约束限制：** 不涉及 **取值范围：** 集群ID **默认取值：** 不涉及 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Content-Type | 是 | String | **参数解释：** 消息体的类型（格式），默认为application/json，有其他取值时会在具体接口中专门说明。 **约束限制：** GET方法不做校验 **取值范围：** 不涉及 **默认取值：** 不涉及 | | X-Auth-Token | 是 | String | **参数解释：** 调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值，获取方式请参见[获取token](https://support.huaweicloud.com/api-cce/cce_02_0004.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表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配置不一致如何处理？](https://support.huaweicloud.com/cce_faq/cce_faq_00493.html) 指南解决一致性问题。 **默认取值**： 集群不可用时默认包含IngressChecker | | extendParam | 否 | [extendParam] object | **参数解释**： 变更集群规格扩展字段 **约束限制**： 不涉及 | 表4extendParam | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | 表示按需集群规格变更作业下发成功 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-cce/ErrorCode.html)。