调用TransferNode，执行数据迁移任务。

调试

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

请求头

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

请求语法

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

请求参数

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

实例ID。
nodeType String Query 是 WORKER

节点类型，可选值：

  • WORKER：热节点
  • WORKER_WARM：冷节点
clientToken String Query 否 5A2CFF0E-5718-45B5-9D4D-70B3FF****

用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一，最大不超过64个ASCII字符。
Array Body 否

请求体。
host String Body 否 192.168.xx.xx

节点的IP地址。
port Integer Body 否 9200

节点的访问端口号。
zoneId String Body 否 cn-shanghai-c

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

返回数据

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

返回结果：

  • true：任务执行成功
  • false：任务执行失败
RequestId String F99407AB-2FA9-489E-A259-40CF6DCC****

请求ID。

示例

请求示例

POST /openapi/instances/es-cn-nif1q9o8r0008****/actions/transfer?nodeType=WORKER&clientToken=5A2CFF0E-5718-45B5-9D4D-70B3FF**** 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****"
}

错误码

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