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
| 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 |
| 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 Default Value Elasticsearch/OpenSearch cluster: ess Logstash cluster: lgs |
Request Parameters
None
Response Parameters
Status code: 200
| 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 |
| 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 |
| 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: |
| condOperationStatus | String | Definition: Flavor sales status. Value range: |
| localdisk | String | Definition: Whether the node uses local disks. Value range: |
| edge | Boolean | Definition: Whether this is a node flavor for edge deployments. Value range: |
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.