更新时间：2026-09-03 GMT+08:00

获取实例规格列表

功能介绍

该接口用于获取实例规格列表，可以得到实例规格版本、集群数据搜索引擎信息、实例CPU核数、实例内存大小等，适用于创建集群完成后，检查实例规格信息，以便及时更新集群。

调用方法

URI

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

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目ID。获取方法请参见获取项目ID和名称。约束限制：不涉及取值范围：账户的项目ID。默认取值：不涉及

请求参数

无

响应参数

状态码：200

表2 响应Body参数
参数	参数类型	描述
versions	Array of EsflavorsVersionsResp objects	参数解释：规格版本列表。取值范围：不涉及

表3 EsflavorsVersionsResp
参数	参数类型	描述
version	String	参数解释：集群版本号。详细请参考CSS使用前必读中支持的版本。取值范围：不涉及
flavors	Array of EsflavorsVersionsFlavorsResp objects	参数解释：规格列表。取值范围：不涉及
type	String	参数解释：实例类型。取值范围： ess：数据节点。 ess-cold：冷数据节点。 ess-master：Master节点。 ess-client：Client节点。 lgs：LogStash节点。

表4 EsflavorsVersionsFlavorsResp
参数	参数类型	描述
cpu	Integer	参数解释：实例的CPU核数。取值范围：不涉及
ram	Integer	参数解释：实例的内存大小。单位GB。取值范围：不涉及
name	String	参数解释：规格名称。取值范围：不涉及
region	String	参数解释：节点规格支持的Region。取值范围：不涉及
diskrange	String	参数解释：实例的硬盘容量范围，单位GB。取值范围：不涉及
availableAZ	String	参数解释：集群可用区。取值范围：不涉及
flavor_id	String	参数解释：节点规格对应的ID。取值范围：不涉及

请求示例

获取项目空间下所有实例的规格。

GET https://{Endpoint}/v1.0/{project_id}/es-flavors

响应示例

状态码：200

请求成功。

{
  "versions" : [ {
    "flavors" : [ {
      "cpu" : 4,
      "ram" : 32,
      "name" : "ess.spec-4u32g",
      "region" : "xx-xxx-xx",
      "diskrange" : "40,2560",
      "availableAZ" : "xx-xxx-xx,xx-xxx-xx",
      "flavor_id" : "2d8daf1b-873f-4c2e-a7b9-2f9cbcf2f213"
    }, {
      "cpu" : 8,
      "ram" : 64,
      "name" : "ess.spec-8u64g",
      "region" : "xx-xxx-xx",
      "diskrange" : "80,5120",
      "availableAZ" : "xx-xxx-xx,xx-xxx-xx",
      "flavor_id" : "b3d33ec6-d58a-40f0-aa51-4f671ce64b2a"
    }, {
      "cpu" : 16,
      "ram" : 128,
      "name" : "ess.spec-16u128g",
      "region" : "xx-xxx-xx",
      "diskrange" : "160,10240",
      "availableAZ" : "xx-xxx-xx,xx-xxx-xx",
      "flavor_id" : "f74419ca-bc91-4558-b4e2-90eeefb37c6e"
    } ],
    "type" : "ess",
    "version" : "x.x.x"
  } ]
}

状态码

状态码	描述
200	请求成功。
400	非法请求。建议直接修改该请求，不要重试该请求。
404	所请求的资源不存在。建议直接修改该请求，不要重试该请求。

描述

200

请求成功。

400

非法请求。

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

404

所请求的资源不存在。