调用UpdateLogstash,修改指定实例的部分信息,例如节点数、配额、名称、硬盘大小等。
调用该接口时,请注意:
实例状态为生效中(activating)、失效(invalid)和冻结(inactive)时,无法修改实例信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求头
该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。
请求语法
PUT /openapi/logstashes/{InstanceId} HTTP/1.1
请求参数
名称 | 类型 | 位置 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|---|
InstanceId | String | Path | 是 | ls-cn-n6w1o5jq**** |
实例ID。 |
clientToken | String | Query | 否 | 5A2CFF0E-5718-45B5-9D4D-70B3FF**** |
用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不超过64个ASCII字符。 |
Object | Body | 否 |
请求体。 |
||
nodeSpec | Object | Body | 否 |
节点规格配置。 |
|
spec | String | Body | 否 | elasticsearch.sn1ne.large |
规格信息,可在产品规格中查看。 |
disk | Integer | Body | 否 | 20 |
磁盘大小,单位:GB。 |
diskType | String | Body | 否 | cloud_efficiency |
磁盘类型。可选值:
|
nodeAmount | Integer | Body | 否 | 3 |
节点数量。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Result | Boolean | true |
实例信息是否修改成功:
|
RequestId | String | 5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1**** |
请求ID。 |
示例
请求示例
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
}
正常返回示例
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Result" : true,
"RequestId" : "5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****"
}
错误码
访问错误中心查看更多错误码。