文档首页/ 云搜索服务 CSS/ API参考/ 集群管理接口/ 变更规格
更新时间：2024-10-17 GMT+08:00
查看PDF
分享

变更规格

功能介绍

该接口用于变更集群规格。只支持变更ess节点类型。

调试

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

cluster_id

是

String

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

请求参数

表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: 忽略副本校验。

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/flavor

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

{
  "needCheckReplica": false,
  "newFlavorId": "ULTRAHIGH",
  "operationType"： "volume",
  "isAutoPay": 1,
  "clusterLoadCheck": true
}

响应示例

无

状态码

状态码

描述

200

请求已成功。

400

非法请求。

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

409

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

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

412

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

错误码

请参见错误码。

父主题： 集群管理接口