调用GetTransferableNodes，指定节点类型和个数，获取可进行数据迁移的节点。

调试

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

请求头

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

请求语法

GET /openapi/instances/[InstanceId]/transferable-nodes HTTPS|HTTP

请求参数

名称 类型 是否必选 示例值 描述
count Integer 是 1

期望获取进行数据迁移节点的数量。
InstanceId String 是 es-cn-nif1q9o8r0008****

实例ID。
nodeType String 是 WORKER

需要进行数据迁移的节点类型。WORKER表示热节点，WORKER_WARM表示冷节点。

返回数据

名称 类型 示例值 描述
RequestId String F99407AB-2FA9-489E-A259-40CF6DCC****

请求ID。
Result Array of Result

返回结果。
host String 192.168.**.**

节点的IP地址。
port Integer 9200

节点的访问端口。

Result中还包含以下参数。

名称

类型

示例值

描述

nodeType

String

WORKER

节点类型，取值包括：MASTER（专有主节点）、WORKER（热节点）、WORKER_WARM（冷节点）、COORDINATING（协调节点）、KIBANA（Kibana节点）。

zoneId

String

cn-hangzhou-b

节点所在的可用区ID。

示例

请求示例

GET /openapi/instances/es-cn-nif1q9o8r0008****/transferable-nodes?nodeType=WORKER&count=1 HTTP/1.1
公共请求头

正常返回示例

XML 格式 

<Result>
    <nodeType>WORKER</nodeType>
    <host>192.168.**.**</host>
    <port>9300</port>
    <zoneId>cn-hangzhou-b</zoneId>
</Result>
<RequestId>3760F67B-691D-4663-B4E5-6783554F****</RequestId>

JSON 格式 

{
    "Result":[
        {
            "nodeType":"WORKER",
            "host":"192.168.**.**",
            "port":9300,
            "zoneId":"cn-hangzhou-b"
        }
    ],
    "RequestId":"3760F67B-691D-4663-B4E5-6783554F****"
}

错误码

HttpCode 错误码 错误信息 描述
400 InstanceNotFound The instanceId provided does not exist. 实例找不到，请核对实例状态。

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