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.
Debugging
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:
|
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:
|
RequestId | String | 5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1**** |
The ID of the request. |
Examples
Sample requests
PUT /openapi/logstashes/ls-cn-n6w1o5jq**** HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json
{
"nodeSpec" : {
"spec" : "elasticsearch.sn1ne.large",
"disk" : 20,
"diskType" : "cloud_efficiency"
},
"amount" : 3
}
Sample responses
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"Result" : true,
"RequestId" : "5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****"
}
Error codes
For a list of error codes, visit the API Error Center.