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

When you call this operation, take note of the following limits:

If the instance is in the Activating, Invalid, or Inactive state, you cannot modify the instance information.


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

This operation uses only common request headers. For more information, see Common request headers.

Request syntax

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

Request parameters

Parameter Type Position Required Example Description
InstanceId String Path Yes ls-cn-n6w1o5jq****

The ID of the instance.

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

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

Object Body No

The body of the request.

nodeSpec Object Body No

node specifications configurations.

spec String Body No elasticsearch.sn1ne.large

The specifications. You can view the specifications in the Specifications section.

disk Integer Body No 20

The size of the disk. Unit: GB.

diskType String Body No cloud_efficiency

The disk type. Valid values:

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

The number of nodes.

Response parameters

Parameter Type Example Description
Result Boolean true

Indicates whether the instance information is modified. Valid values:

  • true: The call was successful.
  • false: The call failed.
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 responses

JSON format

HTTP/1.1 200 OK

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

Error codes

For a list of error codes, visit the API Error Center.