Help Center/ Cloud Search Service/ API Reference (Ally Region)/ API V1/ Specifications Query/ Querying Available Node Specifications for a Cluster
Updated on 2026-09-03 GMT+08:00
Online Debugging
CLI Examples
View PDF
Share

Querying Available Node Specifications for a Cluster

Function

This API is used to query the specifications to which a specified cluster can be changed.

Calling Method

For details, see Calling APIs.

URI

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

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition

Project ID. For details about how to obtain the project ID and name, see Obtaining the Project ID and Name.

Constraints

N/A

Range

Project ID of an account. The value contains 32 characters, consisting of lowercase letters and digits.

Default Value

N/A
Table 2 Query Parameters

Parameter

Mandatory

Type

Description

clusterId

Yes

String

Definition

ID of the cluster to be queried. For details about how to obtain the cluster ID, see Obtaining the Cluster ID.

Constraints

N/A

Range

The value is a UUID containing 36 characters.

Default Value

N/A

type

No

String

Definition

Cluster node type.

Constraints

N/A

Range

  • ess: data node.

  • ess-cold: cold data node.

  • ess-client: client node.

  • ess-master: master node.

  • lgs: Logstash node.

Default Value

Elasticsearch/OpenSearch cluster: ess

Logstash cluster: lgs

Request Parameters

None

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

id

String

Definition

Engine type ID.

Range

N/A

dbname

String

Definition:

Engine name.

Value range:

N/A

versions

Array of ResizeFlavorRspVersionBody objects

Definition:

Version list.

Value range:

N/A
Table 4 ResizeFlavorRspVersionBody

Parameter

Type

Description

id

String

Definition:

Engine version ID.

Value range:

N/A

name

String

Definition:

Engine version name.

Value range:

N/A

flavors

Array of ResizeFlavor objects

Definition:

Target flavor of the change.

Value range:

N/A
Table 5 ResizeFlavor

Parameter

Type

Description

str_id

String

Definition

Specification ID.

Range

N/A

cpu

Integer

Definition:

Number of vCPUs available with an instance.

Value range:

N/A

ram

Integer

Definition

Instance memory size, in GB.

Range

N/A

name

String

Definition:

Flavor name.

Value range:

N/A

region

String

Definition:

Regions where the node flavor is available.

Value range:

N/A

diskrange

String

Definition

Disk capacity of an instance, in GB.

Range

N/A

typename

String

Definition:

Node type.

Value range:

  • ess: data node

  • ess-cold: cold data node

  • ess-client: client node

  • ess-master: master node

  • lgs: Logstash node

condOperationStatus

String

Definition:

Flavor sales status.

Value range:

  • normal: The flavor is in normal commercial use.

  • sellout: The flavor has been sold out.

localdisk

String

Definition:

Whether the node uses local disks.

Value range:

  • false: non-local disk flavor.

  • true: local disk flavor.

edge

Boolean

Definition:

Whether this is a node flavor for edge deployments.

Value range:

  • false: central AZ flavor.

  • true: edge AZ flavor.

Example Requests

Querying Available Node Specifications for a Cluster

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

Example Responses

Status code: 200

Request succeeded.

{
  "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="
    } ]
  } ]
}

Status Codes

Status Code

Description

200

Request succeeded.

400

The request is invalid.

Modify the request and then try again.

403

The request is rejected.

The server has received the request and understood it, but the server refuses to respond to it. The client should not repeat the request without modifications.

Error Codes

See Error Codes.

Parent topic: Specifications Query