更新时间:2026-01-12 GMT+08:00

变更规格(已废弃)

功能介绍

该接口用于变更集群规格。只支持变更ess节点类型,如需变更其他类型的节点,建议使用指定节点类型规格变更

在变更磁盘类型前,建议备份所有关键数据,以免造成数据丢失。

调用方法

请参见如何调用API

URI

POST /v1.0/{project_id}/clusters/{cluster_id}/flavor

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID。获取方法请参见获取项目ID和名称

约束限制

不涉及

取值范围

账户的项目ID。

默认取值

不涉及

cluster_id

String

参数解释

指定更改规格的集群ID。获取方法请参见获取集群ID

约束限制

不涉及

取值范围

集群ID。

默认取值

不涉及

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

newFlavorId

String

参数解释

变更后的节点规格ID或者磁盘类型,由operationType指定。

约束限制

不涉及

取值范围

  • operationType为vm:newFlavorId为变更后的节点规格ID。该参数通过获取实例规格列表接口获取,根据name属性所需要的规格,选择对应的flavor_id。

  • operationType为volume:newFlavorId为变更后的磁盘类型,支持如下类型:

  • COMMON: 普通I/O

  • HIGH: 高I/O

  • ULTRAHIGH: 超高I/O

  • ESSD: 极速SSD

说明:
仅支持同一个Elasticsearch引擎版本下的节点规格变更。

默认取值

不涉及

operationType

String

参数解释

变更规格的操作类型。

约束限制

不涉及

取值范围

  • vm: 修改节点规格。

  • volume: 修改磁盘规格。

默认取值

vm

needCheckReplica

Boolean

参数解释

集群变更规格是否需要检查副本。

约束限制

不涉及

取值范围

  • true: 开启副本校验。

  • false: 忽略副本校验。

默认取值

true

needCheckClusterStatus

Boolean

参数解释

集群变更规格是否需要检查集群状态。

约束限制

不涉及

取值范围

  • true: 开启集群状态校验。

  • false: 忽略集群状态校验。

默认取值

true

clusterLoadCheck

Boolean

参数解释

集群变更规格是否需要检查集群负载。

约束限制

不涉及

取值范围

  • true: 开启集群负载校验。

  • false: 忽略集群负载校验。

默认取值

true

响应参数

状态码:200

请求已成功。

请求示例

  • 变更节点规格ID。

    POST https://{Endpoint}/v1.0/{project_id}/clusters/4f3deec3-efa8-4598-bf91-560aad1377a3/flavor
    
    {
      "needCheckReplica" : false,
      "newFlavorId" : "35b060a4-f152-48ce-8773-36559ceb81f2",
      "isAutoPay" : 1,
      "needCheckClusterStatus" : true
    }
  • 变更磁盘类型。

    POST https://{Endpoint}/v1.0/{project_id}/clusters/4f3deec3-efa8-4598-bf91-560aad1377a3/flavor
    
    {
      "needCheckReplica" : false,
      "newFlavorId" : "ULTRAHIGH",
      "operationType" : "volume",
      "isAutoPay" : 1,
      "clusterLoadCheck" : true
    }

响应示例

状态码

状态码

描述

200

请求已成功。

400

非法请求。

建议直接修改该请求,不要重试该请求。

409

服务器在完成请求时发生冲突。

返回该状态码,表明客户端尝试创建的资源已经存在,或者由于冲突请求的更新操作不能被完成。

412

未满足前提条件,服务器未满足请求者在请求中设置的其中一个前提条件。

错误码

请参见错误码