All Products
Document Center


Last Updated:Jul 04, 2024

Modifies the configuration of a Logstash cluster, such as the name, quota, disk size, and number of nodes.

Usage notes

Before you call this operation, make sure that the cluster is not in the activating, invalid, or inactive state.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request headers

The DescribeEniMonitorData operation does not have operation-specific request headers and uses only common request headers. For more information, refer to the documentation of common request parameters.

Request syntax

PUT /openapi/logstashes/{InstanceId} HTTP/1.1

Request parameters







InstanceId String Path Yes ls-cn-n6w1o5jq****

The ID of the instance.

clientToken String Query No. 5A2CFF0E-5718-45B5-9D4D-70B3FF****

that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length.

Object Body No

The request body.

nodeSpec Object Body No

The information about node specifications.

spec String Body No elasticsearch.sn1ne.large

The specification family. For more information, see Specifications.

disk Integer Body No 20

The size of the disk. Unit: GB.

diskType String Body No cloud_efficiency

The disk category of the instance. Valid values:

  • cloud_efficiency: ultra disk
  • cloud_ssd: SSD
nodeAmount Integer Body No 3

The number of nodes.

Response parameters



Sample value


Result Boolean true

Indicates whether the configuration of the cluster is modified. Valid values:

  • true
  • false
RequestId String 5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****

The ID of the request.


Sample requests

PUT /openapi/logstashes/ls-cn-n6w1o5jq**** HTTP/1.1

  "nodeSpec" : {
    "spec" : "elasticsearch.sn1ne.large",
    "disk" : 20,
    "diskType" : "cloud_efficiency"
  "amount" : 3

Sample success responses

JSON format

HTTP/1.1 200 OK

  "Result" : true,
  "RequestId" : "5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****"

Error codes

For a list of error codes, see Service error codes.