调用ValidateShrinkNodes,校验指定实例中的某些节点是否可以缩容。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求头

该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。

请求语法

POST /openapi/instances/{InstanceId}/validate-shrink-nodes HTTP/1.1

请求参数

名称 类型 位置 是否必选 示例值 描述
InstanceId String Path es-cn-nif1q9o8r0008****

实例ID。

nodeType String Query WORKER

需要缩容的节点类型,可选值:

  • WORKER:热节点
  • WORKER_WARM:冷节点
ignoreStatus Boolean Query false

是否忽略集群健康状态:

  • true:忽略
  • false(默认):不忽略
count Integer Query 2

节点数量。

Array Body

请求体。

nodeType String Body WORKER

节点类型,可选值:

  • WORKER:热节点
  • WORKER_WARM:冷节点
host String Body 192.168.xx.xx

节点的IP地址。

port Integer Body 9200

节点的访问端口号。

zoneId String Body cn-shanghai-c

实例节点所在的可用区ID。例如,上海可用区C为cn-shanghai-c。

hostName String Body es-cn-pl32xxxxxxx-data-f-1

云原生ACK架构集群的节点名称,可调用ListAllNode接口获取。

返回数据

名称 类型 示例值 描述
Result Boolean true

返回结果:

  • true:可以缩容
  • false:不可以缩容
RequestId String F99407AB-2FA9-489E-A259-40CF6DCC****

请求ID。

示例

请求示例

POST /openapi/instances/es-cn-nif1q9o8r0008****/validate-shrink-nodes?nodeType=WORKER&ignoreStatus=false&count=2 HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json

[ {
  "nodeType" : "WORKER",
  "host" : "192.168.xx.xx",
  "port" : 9200,
  "zoneId" : "cn-shanghai-c",
  "hostName" : "es-cn-pl32xxxxxxx-data-f-1"
} ]

正常返回示例

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Result" : true,
  "RequestId" : "3760F67B-691D-4663-B4E5-6783554F****"
}

错误码

访问错误中心查看更多错误码。