Changing the Specifications of a Specified Node Type

Function

This API is used to change the specifications of a specified node type. The following node types are supported:

  • ess: data node

  • ess-cold: cold data node

  • ess-client: client node

  • ess-master: master node

Debugging

You can debug this API in . Automatic authentication is supported.

URI

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

Table 1 Path parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID. For details, see Obtaining a Project ID and Name.

cluster_id

Yes

String

ID of the cluster that you want to modify specifications

types

Yes

String

Type of the cluster node you want to modify.

  • ess: data node

  • ess-cold: cold data node

  • ess-client: Client node

  • ess-master: Master node

Request Parameters

Table 2 Request body parameter

Parameter

Mandatory

Type

Description

needCheckReplica

No

Boolean

Indicates whether to verify replicas. Its value can be true or false. Replica verification is enabled by default.

  • true: Replica verification is enabled.

  • false: Replica verification is disabled.

Note

Master and client nodes are not data nodes, so they do not need to check replicas no matter this parameter is set to true or false.

newFlavorId

Yes

String

ID of the new flavor. This parameter is obtained by calling the Obtaining the Instance Specifications List API. The API compares the values of the name attribute and obtains the ID of the flavor higher than the current flavor. Only the node specifications of the same Elasticsearch engine version can be changed.

Response Parameters

None

Request Example

  • {
      "needCheckReplica" : false,
      "newFlavorId" : "35b060a4-f152-48ce-8773-36559ceb81f2",
      "isAutoPay" : 1
    }
    
  • {
      "needCheckReplica" : false,
      "newFlavorId" : "35b060a4-f152-48ce-8773-36559ceb81f2"
    }
    

Response Example

None

Status Codes

Status Code

Description

200

The request is processed successfully.

400

Invalid request.

Modify the request instead of retrying.

409

The request cannot be processed due to a conflict.

This status code indicates that the resource that the client attempts to create already exists, or the request fails to be processed because of the update of the conflict request.

412

The server does not meet one of the requirements that the requester puts on the request.