文档首页/ 云搜索服务 CSS/ API参考(联盟区域)/ API V1/ 规格查询/ 查询指定集群的可变更规格列表
更新时间:2026-09-03 GMT+08:00

查询指定集群的可变更规格列表

功能介绍

查询指定集群可以变更到哪些规格

调用方法

请参见如何调用API。

URI

GET /v1.0/{project_id}/resize-flavors

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

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

约束限制:

不涉及

取值范围:

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

默认取值:

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

clusterId

是

String

参数解释:

指定查询的集群ID。获取方法请参见获取集群ID。

约束限制:

不涉及

取值范围:

集群ID。

默认取值:

不涉及

type

否

String

参数解释:

集群节点类型

约束限制:

不涉及

取值范围:

  • ess:数据节点类型。

  • ess-cold:冷数据节点类型。

  • ess-client:Client节点类型。

  • ess-master:Master节点类型。

  • lgs:LogStash节点类型。

默认取值:

Elasticsearch/OpenSearch集群:ess

Logstash集群:lgs

请求参数

无

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

id

String

参数解释:

引擎类型id。

取值范围:

不涉及

dbname

String

参数解释:

引擎名称。

取值范围:

不涉及

versions

Array of ResizeFlavorRspVersionBody objects

参数解释:

版本列表。

取值范围:

不涉及

表4 ResizeFlavorRspVersionBody

参数

参数类型

描述

id

String

参数解释:

引擎版本id。

取值范围:

不涉及

name

String

参数解释:

引擎版本名称。

取值范围:

不涉及

flavors

Array of ResizeFlavor objects

参数解释:

可变更的目标规格。

取值范围:

不涉及

表5 ResizeFlavor

参数

参数类型

描述

str_id

String

参数解释:

规格id。

取值范围:

不涉及

cpu

Integer

参数解释:

实例的CPU核数。

取值范围:

不涉及

ram

Integer

参数解释:

实例的内存大小。单位GB。

取值范围:

不涉及

name

String

参数解释:

规格名称。

取值范围:

不涉及

region

String

参数解释:

节点规格支持的Region。

取值范围:

不涉及

diskrange

String

参数解释:

实例的硬盘容量范围,单位GB。

取值范围:

不涉及

typename

String

参数解释:

节点类型。

取值范围:

  • ess:数据节点。

  • ess-cold:冷数据节点。

  • ess-client:Client节点。

  • ess-master:Master节点。

  • lgs:LogStash节点。

condOperationStatus

String

参数解释:

规格售卖状态。

取值范围:

  • normal:正常商用。

  • sellout:售罄。

localdisk

String

参数解释:

是否本地盘。

取值范围:

  • false:非本地盘规格。

  • true:本地盘规格。

edge

Boolean

参数解释:

是否边缘区规格。

取值范围:

  • false:中心可用区规格。

  • true:边缘可用区规格。

请求示例

查询指定集群支持的可变更规格列表

GET /v1.0/{project_id}/resize-flavors?clusterId=xxx

响应示例

状态码:200

请求成功。

{
  "id" : "cf7e2c8f-096c-4fcf-b174-1ebe060679fb",
  "dbname" : "elasticsearch",
  "versions" : [ {
    "id" : "01f53413-0a58-4b0c-848a-f625846bae23",
    "name" : "7.10.2",
    "flavors" : [ {
      "cpu" : 2,
      "ram" : 8,
      "name" : "ess.spec-2u8g",
      "region" : "cn-north-7",
      "typename" : "ess",
      "diskrange" : "40,800",
      "condOperationStatus" : "normal",
      "localdisk" : "false",
      "edge" : false,
      "str_id" : "b58dfcfb-5f73-4f05-8c06-5171b12fd618="
    } ]
  } ]
}

状态码

状态码

描述

200

请求成功。

400

非法请求。

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

403

请求被拒绝访问。

返回该状态码,表明请求能够到达服务端,且服务端能够理解用户请求,但是拒绝做更多的事情,因为该请求被设置为拒绝访问,建议直接修改该请求,不要重试该请求。

错误码

请参见错误码。