文档首页/ 云搜索服务 CSS/ API参考/ 集群管理接口/ 指定节点类型规格变更
更新时间:2024-10-17 GMT+08:00

指定节点类型规格变更

功能介绍

修改集群规格。支持修改:

  • ess: 数据节点。

  • ess-cold: 冷数据节点。

  • ess-client: Client节点。

  • ess-master: Master节点。

  • lgs:Lgs节点。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

cluster_id

String

指定待更改规格的集群ID。

types

String

指定待更改的集群节点类型。

  • ess:数据节点。

  • ess-cold:冷数据节点。

  • ess-client:Client节点。

  • ess-master:Master节点。

  • lgs:Lgs节点。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

newFlavorId

String

operationType为vm时,newFlavorId为变更后节点规格ID。

该参数通过获取实例规格列表接口获取,根据name属性所需要的规格,选择对应的flavor_id。

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

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

  • COMMON: 普通I/O

  • HIGH: 高I/O

  • ULTRAHIGH: 超高I/O

  • ESSD: 极速SSD

operationType

String

操作类型。可选值:vm和volume,默认为vm。

  • vm: 修改节点规格

  • volume: 修改磁盘规格

needCheckReplica

Boolean

是否需要检查副本,取值范围为true或false。默认开启校验。

  • true: 开启副本校验。

  • false: 忽略副本校验。

说明:

Master和Client节点不是数据节点,因此不需要进行副本校验。即使选择true,也不会进行副本校验。

isAutoPay

Integer

是否自动支付。下单订购后,是否自动从客户的华为云账户中支付,而不需要客户手动去进行支付。该参数适用于包周期集群。

  • 1:是(会自动选择折扣和优惠券进行优惠,然后自动从客户华为云账户中支付),自动支付失败后会生成订单成功(该订单应付金额是优惠后金额)、但订单状态为“待支付”,等待客户手动支付(手动支付时,客户还可以修改系统自动选择的折扣和优惠券)。

  • 0:否(需要客户手动去支付,客户可以选择折扣和优惠券)。默认值为“0”。

needCheckClusterStatus

Boolean

是否需要检查集群状态,取值范围为true或false。默认开启校验。

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

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

clusterLoadCheck

Boolean

是否需要检查集群负载,取值范围为true或false。默认开启校验。

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

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

响应参数

请求示例

  • POST /v1.0/6204a5bd270343b5885144cf9c8c158d/clusters/4f3deec3-efa8-4598-bf91-560aad1377a3/ess/flavor
    
    {
      "needCheckReplica" : false,
      "newFlavorId" : "35b060a4-f152-48ce-8773-36559ceb81f2",
      "isAutoPay" : 1,
      "needCheckClusterStatus" : true
    }
  • POST /v1.0/6204a5bd270343b5885144cf9c8c158d/clusters/4f3deec3-efa8-4598-bf91-560aad1377a3/ess/flavor
    
    {
      "needCheckReplica": false,
      "newFlavorId": "ULTRAHIGH",
      "operationType": "volume",
      "isAutoPay": 1,
      "clusterLoadCheck": true
    }

响应示例

状态码

状态码

描述

200

请求已成功。

400

非法请求。

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

409

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

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

412

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

错误码

请参见错误码