调用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. 实例找不到,请核对实例状态。

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