調(diào)用ShrinkNode，執(zhí)行集群節(jié)點縮容操作。

調(diào)用該接口時請注意：

在進行集群數(shù)據(jù)節(jié)點縮容前，需要先將待縮容節(jié)點中的數(shù)據(jù)遷移到其他節(jié)點，保證待縮容節(jié)點中無數(shù)據(jù)后，再進行集群節(jié)點縮容操作。

調(diào)試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求頭

該接口使用公共請求頭，無特殊請求頭。請參見公共請求參數(shù)文檔。

請求語法

POST /openapi/instances/{InstanceId}/actions/shrink HTTP/1.1

請求參數(shù)

名稱 類型 位置 是否必選 示例值 描述
InstanceId String Path 是 es-cn-nif1q9o8r0008****

實例ID。
nodeType String Query 是 WORKER

需要縮容的節(jié)點類型，可選值：

  • WORKER：熱節(jié)點
  • WORKER_WARM：冷節(jié)點
clientToken String Query 否 5A2CFF0E-5718-45B5-9D4D-70B3FF****

用于保證請求的冪等性。由客戶端生成該參數(shù)值，要保證在不同請求間唯一，最大不超過64個ASCII字符。
ignoreStatus Boolean Query 否 false

是否忽略集群健康狀態(tài)：

  • true：忽略
  • false：不忽略
count Integer Query 否 2

縮節(jié)點數(shù)量。

重要 此參數(shù)僅適用于ACK架構(gòu)實例，且不支持填寫body中的host參數(shù)。
Array Body 否

請求體。
host String Body 否 192.168.xx.xx

節(jié)點的IP地址。
zoneId String Body 否 cn-shanghai-c

實例節(jié)點所在的可用區(qū)ID。例如，上海可用區(qū)C為cn-shanghai-c。
nodeType String Body 否 WORKER

需要縮容的節(jié)點類型，可選值：

  • WORKER：熱節(jié)點
  • WORKER_WARM：冷節(jié)點
port Integer Body 否 9200

節(jié)點的訪問端口號。
hostName String Body 否 es-cn-pl32xxxxxxx-data-f-1

云原生ACK架構(gòu)集群的節(jié)點名稱，可調(diào)用ListAllNode接口獲取。

返回數(shù)據(jù)

名稱 類型 示例值 描述
Result Boolean true

返回結(jié)果：

  • true：縮容成功
  • false：縮容失敗
RequestId String F99407AB-2FA9-489E-A259-40CF6DCC****

請求ID。

示例

請求示例

POST /openapi/instances/es-cn-nif1q9o8r0008****/actions/shrink?nodeType=WORKER&clientToken=5A2CFF0E-5718-45B5-9D4D-70B3FF****&ignoreStatus=false HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json

[ {
  "host" : "192.168.xx.xx",
  "port" : 9200,
  "zoneId" : "cn-shanghai-c"
} ]

正常返回示例

JSON格式

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

{
  "Result" : true,
  "RequestId" : "C82758DD-282F-4D48-934F-92170A33****"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。